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RADIO AND TELEVISION INTERFERENCE 



The (^uLpment described In thle tnjni1.1l ^Ti4?ratJ^s dnri ciacs radio 
frtiqiiEiicy BTterf^fM It it la nat in^tallE^ qnd uped ^irop^rly* ChcLt Is 
in Rtrict accordATHZE with mr i Mt Rictione 1 It vwy cniise tnterfereim 
to radJo nnd Cel^vtsloTi reception* 

This dquIpQETlt huE been EEBted ^nd cOmpL^^H with ttiE llmitE For a 
CIabft B compitti riK device In flcccjrdence with the specific At Ions In 
Suhpart J of PflrC 1^ of FCCl n^lea, Thesp ruJes ^re detilRned to 
provide reasonflbl^ protection o^jilTipt nuch InterFerEnce In a 
reBld^nLldl Inat alia t Ion. However, there f e no guarantee tbnt the 

Intpx-f erence will not occur In a partJcular t net^llfitloT^p 

Vqm cqh clet^TTT>Ene i^etbEr yot^r conpiitEr is cauflinn IntErf ETEncie by 
turnCne It f>ffr If the Interference stops, it v^s prohably cdusej? by 
the cnnputer* IE yotir computer doea cause interference to rwflo or 
television reception, you cfln try to corre:;t the interference by 
usInK one or more of the following ivsaures; 

- Torn the TV dr radio at]teiina \intll ch« ti^erfer^nce etops^ 

" hove tbs ponputer tP one vide or the other of the TV nr radio . 

- Move the computer farther ErtHd the TV or radio. 

- ?Iu]^ the E^coDputer Into an outlet that Ifi on a different tirtult 
from the TV or radios (That Is, raalte certain the computer and the TV 
□ r radio are on qlrcultB controlled by different circuit hreekers or 
fiLse^-) 

If necefi^rv^ yoi] should ?oTiflh]lt your defllpr or an experienced 
radlo/televifiEtin tethnlclan for additlonel sueB^stions. You niay find 
the Foilovli^ boolclet prer^ared by the Federal ronDunlcations 
Connlsslon helpful: 

"Hov to Identify und Resolve Radio-TV Interference Problens'^ 

ThlQ hoaklet is avaiTflhle frCo the U.S. Govermieilt Prlntir^ Office, 
Ua^hinf-ton, DC <;tock inmher , 



PREFACE 



TIiIr funual has tVO prlnary functions 

Li*<i thi> POS fDUt Op«ratf.nK SyatebJ: 

vntiple^ tc ptcottipaoy esplanat Lorb of 

Th# JETond Function of the nunua] ia 

DOS* The AppEndiceSp Quick HefersnQE 
vlth this funcElon la ndnd- 



F Th^ flrat is to t«Ach you hcv to 
thE Chapters of the manusl use 

bow the varloiJB DD£ comaandE vor^^ 
to ^erve sb a reEerfrnCe eulde to 

Cardi and thE Indices vere pl^uusd 



To us^ an ApplE Dlst II, you need jin Apple Tl cofflputer with at IftaSt L&E 
ot oiEiiiDry — but iB recoBuiended, since the IM ?y»t«b allova littla 

Hiury ap4Ce to fitore proRrdH- lo fact, the HUFFTN pro^raD and th« 71D 
program on your Svfitem Maater Diflkette need 32E of mewry to run- Fot 
UHlns Apple DlBlt TI with Appleflflft nu caaett* tape or on dlak^CCe^ your 

coDiputer tnulit have St leMt 33K of Dsorj. 

The Apple Difllt II la s "floppy" disk nult lAlch allmia you to store sod 
retrieve infor»»tlOil nnch nore quietly and conveniently thse you caq 

^^.^"i^^SS"^^""" !^ StorEd and retrievtd frnn a 'Miskette'^. s 
SHli (shout 5-iiich dlainecer) specitlly coated plastici diafc utilch Is 

perunently aealed in a square plastic case* 

□ne of Ihe moBt [nportant advantages to using Dink IJ la chat 

lofcrHtlon ±B stored and retrieved hy a ntH under wM^h it is flled- 

A proftram that CStaloga phone oumberB rt^ht be B^vfld With an Inttniction 
Such as 

SAVE PHONt NUMBERS 

ond retrieved With an equslly sinple cowuF^d- The name PHOWE NDHBEaS 
under which th^ progran ia filed ia a tils uane . 

The pro^^tflra that au t cfm 1 1 q*1 ly keep track of files* sav* and r*trlavs 
inforrMtloD^ and do s tiultitude cE othfir houQeVeaplnB tssks sra csll^d 
the EiiBfc Q^eratlna Systea t usually shortened to "[JOS'^ Some pEoplt ftay 
"doss" and ntbers My "dee oh »a"p LEarnlng co use DOS and the diak 
consists qF learfilng a few apeciai DOS conmands deacrlbfrd in thia 
Ofinusl. These ccminandB csn be used ss ^Xtensiana to either Appleioft or 
Integer Basic or inachlue language prOjtAia. 

At som places yau^Il aee ths 4yAal 

precEdlnft a psrafiraph- This ayofcol iudio^tes an unusi^iL featurE to yhlch 
you ehpuld be alert* 

The syiAol 

prsLedfS patrsgraphs dEEcrlbing altuationa frm vhlch BASIC nay he utiAble 
Lo recnver^ You Vill lose 7DUT prOErao. probably have to rs^tart DOSi 
and MBY have Co r#-Start BASIC^ 



NOTE ^" 



Thlfi ■amiBl applied Lq V«TAi4M oi Hhat 
f?P«rt» tfl 16 aectnrfl* Tliit isp DOS vtHion 3-3 
and aubQcqu^Qt* If you ha'^e ACl carlltr ^raL(3n 

QOa, it will operate Id L3 «EttDrB- Tc updaU 
TOUT 13 Becitflt DOS to E6 s^ctdhffl* cLtdngfl t>l« 
proAi <ni yoiii: dl*k toncrcfJ-Ler card hb infittucced 

In Appendix Md U^e th^ HU7FIB pro^raia to 
oKrvfi yout ddta tc 16 dCCtor digltfitt^B- To botst 

ua« thd USICS 1>i«kectt thit conaa ulth jour Disk II 
or your DlalL 13 Dpdate hit' 

Uivdtr SOP* clTH^jng traces 1 a diskette converted 
b]? MtiPFIB v^y turn out to be ucninnable ^ Thlfi 
hftpp«M Vhen thfl pToar&ni on the dlak^tt^ ^KpecCfl 
to flocf IrcfltrtictlOfl* at ftpaclfic It-catiDOB on the 
dlakett* liflotfr KMt prdgrdnui dovi'l: ELt thAt 
{:ACegi>ry, but A £ev do- fltfv^ttibur * H[fF?IHEng 
» dl^kett* won^ t ^^rm yuur 13 eoctor dlsk«tt*p 
and ynu caa always boot 13 pecmor dlskAtt^a 

UQlng BASICS- 
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TION AND HANDLING 



if 

m 



|;^iin«.c 1 1 n|t 
l4ataiiin.il thi o-t r^a 1 1 €i r 

CdTd Qf tbf Difrk 11 and Dis».Plt*?S 
E¥t»vrt;Q^ and ft«E«r^tiYfc Diak.£tled 



Your Dick II BTflta coDflliti ot Hvatml Abdos thus jou vtll flndc 

1) The disk drive (the naln boKi* 

2) A prlnted-circult card (thf coritnUvr urd} 
that pLv&s Into tiiL^ Apriii- n- 

3) A f la L r Ibbon cabii? h .i] Lidv f asttned 
CO fh^ Jtst drl^^h for connect ing 

tLiA didk dtlve to the ccnttroller card« 

4) A. "GTSm EUSTER" diskette* 

If JD11 have pUrChAd^d A drive only <£or exaniple, as a second drive for your 
Controller card) your ayatem will not include all of the ab^ve Items- 

S^ve th^ pdckinf HterLdl in cd64 you Wish LC tradsport your disk — or Ln 
tlie lAUketf «veiiC rw nttum It to rour or C» CIh fACEovr lot 

Special Wotfl "* 
B«tor« cOMectlng or dlBccmnectliiK 

on thm Disk II or Appl« It 

TBBM OF? THK POHHli 
TUP Id « VDBC- 

COMOCflNO THE CAUI 

1ji Listj ^ the iJl d rive wl 1 1 be connected to the rontr&ller card by the 

f J .1 E ^ rd bhon - 1 L r able * One end of this rlhbon qable la already fastened 

tu tht: -illsk Ltr[v4:. If thi» is your tir^t disk drlvcj th« covmect^r at the 
end o( thii ribbon cAbl* fra chlB drlvfl should hs AttHhtd Co cbc upp4r 

set of pj.n3 on the cMtNl]« CUd'^ Thlfl flfct cootrollsr UFd pliU IM 

Iftbsllsd ''DJtlVli 1'^ 

Cnitlcm 

l£- clw «bla £r« eke dlfik dtlvc b> tb^ co«r«lX«r «ud U not p^Ba*' Iah 

tk* CHtnlUr card corracdj^ cnuUtr^lo pk7tl«l d*M^ CAA k« dou to 

ck« dl«k dtlve unit md ito «l4ccmtt«4« tti u*un corr«u ^uobljr^ b« 

sure to plug the ribbon Cdbls Into th« coDtrDllsr urd belore l»CftlUiiB tke 
controller card into the cnpv(4tri li»c^IlAti«i tips Eollow* FlfeCj 

don't jan the cable between th* COtmcctor MTld the controller card* Wh^iY tht 
cabl* ta plugged into Chs controller card corrccC , ^ln- t.ih^i? -^hoLjld ewlt 
tron Ita connector on the aide of ttte ci?nnector that i'- '^^U'\y ftChTn the 
contrcller cardp as abuwn in the pbtoCograph- Sacondi Pfedke 5ur« that all the 
pl« oE eke uuCrollftT cmrd^a coniwcCDf r> ^nto th^ ^dtehlug holss in ttae 
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1^ 





flbbiHn ^■^th]^^'^^ c o nn*^ c t or ■ By maklE^f* tho cnjaririLC I -nn b^'l(ire in^r.iMinK tne 

card^ jQU can actoaLLy poe ih.it nil Che plna are going into the holfcft 
ct^rtoctly^ 





" Connecting the tabl* to th* Cofitroller 



If yau are Infltallliig a second di&h dtive^ ycm should connect the ribbon 

cable fron the a^cond drive to tkc Inw B4C of pint on roat ooacrollor* 
This set of pins U l.abe].ed "DUTE 2^- rflkt tke 4H cun *(U^litt <ilil4 

eoDMctor OS you did vltb Ehs fint* 

If yoa an updating mn oarllor vsnioa of DOS Co alzboan B*cton, rou vtU 
ned to ckimgc cwo pran* on joor ndotlni ooacrollor card* R«d Appudlx D 
to find out kov to do tkii* 

wsuuMG Tiff coMnoun 

to install th^ IT Chnt; t-/i M * r ^Ard, which >'Ou havo olrudy CDimaotod to 

eke diah drl^/e via ttae ribbon cable, you b^lll Sioply plug th« UUtFOllftr 
card lato a ^odct ins3.dc tho Apple tt, a? folloi^s: 

I* Turn off the power switch at th* back of the Apple II* Thla ia 
tvportant to prevtnt dauge to the coHputer- If th« pover Is on, rsHval 
or Intsrtlon oC a? urd conld onnst peraanont dvsKS to botk the osM And 
Ch4 App]4 11^ 

2* KtBva tke cover froa the i^ple II« Xkie is kr puXllns ^ OA th^ 

ocMr St the ner edge (tke edgo fntheat ttm. the ksybDud) uatil the two 
^oraer Eodteuen pop epert* Do not qootlme to lift tbe V«t v^bOt bat 

slide the cover beokvnrd Until It ccvei ffee- 

Tn.RJdo the Apple 11^ acroaa the rear of the circuit board, cher^ Is A 
rivw iyf r i f^h t long , narrow aocketa called "slots "+ Thf^ IcEtnoat one 
I look 1 ng At I lit" c^^mi^tjtc f E Cr^m t hi" keyboard c^nd J Is slot flfl^ and the 
rlGhtfnoat on*^ Is slot ff7- i.u^^it- slut ^fi, one socket to the left of the 
fl|tlitTTUBt ancketi The controller ^^rd ru^y be placed in any alot except 
■ lot I0t the leftnost^ Hovever* Apple's etJindard location for the d±ak 
«ontroll«T «rd is slot §6^ and nuE Apple doftvato (eftd tkl4 mUiuAl) l4 
wrlttm vith that location In kind* 
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4^ BE SURE THF. mwF-R IS OFF ftVJ^RE YOU THSFRT OR RElDVR AMT CUD FRfH TQE 
ODHFUTER^ In^t^ri the "fJn^crt" portion c?t the controlleT ItltCn alot M< 
Th* Eln^L-rs" poM]i>Ti viLJ ^-iifH^r the soczket ulth some friction and vlll. 
thM firmly, ilnnd Lhe ffngers mate electrical contact^ it !■ 4 a«d 

ld44 to keep you^ Eingera frm tCnudhlna th«, B4f4>r« iD^tnllAtlcm^ you 
«ay Vl4h to iM rubbing mlcotw]: to^ciun tbft riAaHW m tl» board {^Mp 
optloMlly^ you* on (liSB«ri It jm^n m lftclliiod>* 




luottiDs Ch« CcmltoUor Cud 



5- Adjuat the ribbon cable qo Ic lays flat and p^asts Ov^r one of the 
aT«as between tllC vertical opertlriES In the back of the Apple II dAAfrp U 
fthEran tn the dravlng. When the lid i-^ Installed it will cl^mp down Zhm 
Ubla ud 4«t U 4 scrnln rellEf. 




lepiace th« cover o£ tho ^pt« Xl; twdm to atm by »lidld| IA« 
EtMt ad£e of tbt coMT lilt* plKt^ Pn» dom m tba tw nu corrtet* 
ntll tbfrr pop into p3A«^ 

7, The tUst II controTlf-r li Installed, and tha ll Hy HV b« 

turned on- FLiic-: the diak dri-vt In e convenient tvutlimr uaUlly 
4lQnftBld« of or on cap of your Apple II- 
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iMncuum Mwnpu MSK rams 

Uppar *■< of ptHi liib«lvd ."DHin I", ud lli* ncoad atcadiAd to tfa« lotr 

MC ar jiii*, Ubvlait "DMW TiMi- ant dlfffc driv* should be attaqheri r,. 
th« mtlVE I pin tni tha. ncoad to niVE 2 piu oa i^e card in sLct Thi- 
Ehlt4 and'edarth drlwa uliovU b'a atcadiBd to the driv£ 1 DRIVE 2 pins, 
^ ^ r*Bp«CElvalT, on ■ urd la alDG fSf fieth ati tUCb drivaa ACCach En 

DEIVB t ud mVK 3. plBt m a utd la «1dG H, nd «□ on* 



Tf yoti have injltlple drlveflp It ia n good Uu to UWl th« Iront of uch 
drivp with Its Jiiot and driv^ iMbef *liiH yoar progr^iV vtll »£« to th« 

■ riMk? hv thosp ni^adn^ts- 



e ^ CARE OF THE DISK II AND DISKETTES 

TTio 1>iak II drlv*, vnltim AppU 11^ la a wdmlul dndu^ vlCft acptot* 
^ And TTiDvlnit paTt4* TbaraforA It la fiQBewbat nore d«llutO rtf* Ui* 

CDtnputcr- Rough hwdlln|i auch aa dropping the drivat OT ^rrtug tbliva 

Ej; 3 drop on itt can caua^ it to EsaUvnction- The drive ghnlld Kt'b* pl^Ud 

beildf* &r on a TV set^ alnce the strong iA£n*tic ritUa put dat by TTa Hy 
HU0t ddm^K^ to the magnetic properties oE tha drlw« If 1a dOUbt^ lOcUa 
disk drivea at least 2 feet from any iT aet* 



Each diskette Is 3 i-malL (about 5-inch diameter) plastic dlafc coated SO 
t hrU LnfomaLlon tajy he *ti?r€d on and erased frou Ita aurface* Tha 
Lu.iUng U alDillar to ch# nagnetic coating On recordlne t4pa- The 
rr- 3 dlukette ia r^rMnCntly Sealed in « fli^b4r« black plastic COV«T vhlch 

^ prote<:tB it, helps keep it clean and allna it to spin Craalj* Thi* 

^KIuI* la n^veir opened^ 



Tb« "floppy" ccua from tha fact Ch«t tha dlakatta fa flexible* 01d«r 
m^uHr tttfonation storaga d^ice« thut worked on ainrilar priq^ipjes 
uatd ngld disk** Hhllft the diskette (and Ita plaatic cover) are aoBcvh^t 
flo^bla^^ utuia;^ be4d(Tie the diakttta can dus* It- Tbc dl^cftt* cnvnr 
unUluf both Inbrloactm and cleaqiq^ «BcnCtf to at«d troobl* frM 
oparatlon trtat cover* with raap«ct. 

Never let anythiT^g tOUCh th* brovn or gvey aurface of the diskette itaelf. 
Haadle the dl^kett^ hj the black, plastic COVtr only- When a diskette la 
nut in uae, keep tt In the paper pocket th^t it came In- Th«ae pOck^ta 

are treated to HlnimlEe atatic bulld-tjp uhlch AtcracztS duat« It is bast 
t4> store diskettes Vertically when they ara oDt In nae* Vljirl notebo^^ 
t'Hpc>clsL]j made for thla purpoa* Art c OflVOttI«at-■ 
DiBkettea hoL^ A treacndous Auount of Inf onoatlont a fltfigle diskette can 
hold OV«r 1,UA>W blta of infonution^ An indivldoal bit df 
infomtldnt tharefore^ occupies a vary aull portion of ti^ dlsketta^ An 

tnvi^ihT^^ -^crEitch on the surfuu tbm dlakacta, or nu ■ flAwpTtAlt 
csn raute errors. I>o not plM€M dlakfltta* Qfl diTQT OF tnuy BmKtmt d* 

ihot let thek C4ll«CC dufet- 
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ro write on d diskette Ubel , ubp a FT_LT TIP peup Do Dct press bard- It 
±B bent dot to write on a Uhel Attached to d dlDkette^ tut to write mi 
the separate labtfl, th^n Bttflch it te thfi diskette^ 

Kftep dlpkettu dUay from ugnetlc: Eld1dd» Thla meuB keep thea iWdy 
frow electric: nntors and lUgnetfl; they ahoijld nat he |)lACred en COp of 
*ldcttroDlc devLcei Huth as television aets- H^ty say be temporarily laid 
on the App]« II Dr the I3l4k TT- 

Dlqketted are adnbltlve to extrcaes ef c^mperdtute. Reap diskettes out of 
the aun^ and avay fran Other eourcda Dt heat that can cause them te verp 
nd/or loBe data. On U^t ddyB, car trunks [ar da^hboarde) C«n be diskette 
klllftFa^ Dlakette^ Operate satlaf actnrl Ly up to 12^ dtgrDtifl fahrcnhalt 
(51,7 CeUlusJ^ which not very bat. The flrat evidence of Jieat danaee 
la A faT«rp«d nr bant blA^k plastic cover. 

With raasanJlblc care a diskette Will give you an average life sf it hnurd 
— vKlch Is B IcYt. *fhen you cnn^lder tht lew aecooda it takas to LOAD moot 
programs. VlEh JuSt a little Mt of Cdri^]ea^e«& p a diskette may Rlva you 
no sarvlce At dll. 




M5EBTMG AND RMOVMG DISKETTES 

UelnE a disk drive ia jar ^Lilqkec flfld seller than ualna a cassette 
recoTider, however bDne care is necessary to protect the dlskattaa- The 
drive Itself must also be handled with sorrte care- Tht drive donr lA 
opened by pulling outward an ltd battOm edge^ The diskette is then 
slipped InCD the slot with Lhe labeL upwards , aa shown In the 
photograph. Tlie edge oE the diskette with th4 oval Cutnut In the 
dl^kecte^C aquare plaatlp cover iHould dnteiT the drive Eirat ■ The edftO 
of the dUkacte with the l^bel iheuld *nrer the drive last» 



A Good 
KULE OF mlJHfl 

Hold A diskette with jaur right thuhb over the Eaheli 
that pretty mch ineurea the correct orientation 
Vben you put lh« diskette in the drlve^ 
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IiuertLns a Dlek*tto 



fush the diskette B^ntly until Che diskette la entirely Into the drlve- 
n<y not bend the dlskettel IF it is pushed in toe hard^ the diakette can 
be penanently d^iuged- Clos4 the drtv? door by puflhlng it d«vn again- 
Tthe two netAl fingerd (whicb can be seen inside the slot uhen the drive 
door Is closed} should juftt clear the dIeVetce ai tb« door cloaea- 

A diskette is removed by opedlug the drive dder And pullldg the dIakaEC« 
careEuiry out of tbe drive. The act of ftpenlng the diak drive dfior Ii£tB 
the "head'^ off the disk. If yau pl^n to lejive an unused diskette Jn a 
drive for several bours^ it's a ^Qoi idefi txi open the door eo the head 
von^t reit on the diskette^ 




EdRVEX rcfuove a diskette while the drive's "IN USE'' light Is ooh Thlb uy 
ptrnanently damage the diakettOh and ta qlnoot QUra to destroy the 
lnInr*AtlDn On lt« In such a caaep the diakette can usually be r*-liA«df 
but you won't be able to recover the Lost Infomatiaoi 
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CHAPTER 2 
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I* SptcUl Xaya -"-^--^ 

n taDtlQB DOS 

17 IJ JkiDEfB( Doua'E Vozh 

15 LOADlna AAVBlOB vltb DUS 

16 CATAUC 

16 Ulut'« In t HabbI 

17 kUAHEtas TlLa* 
le QELETElaa riUa 

1£ Karavvrlni tram Lctilducal BaAeti 



UCHSROUND 

Icirnln^ to lue th« dlBk and Its opcradng lyst^n consista Ledmino d 
£cv special Instructional sevemJ of vhlch ato >t rftlght Ft^rvard 4^xten«lciii» 
of fdfuUlar BA&IC inatructionB* This nanudl aAdum^a rhat you're fanlllar 
uitb the Appli^ Hp and fval dainEortdblfl writing dirtrpLe M!1IC prdgrDtfW- 

Tcp lcArr\ h^y^ to uat the Ap^ta 11 and Int^ser BAf^IC, cdi]Sult thci Apultr 11 |EIm 
B^SIC PcQflroffiiBina Hangjil (Appl^ PTCndcict ?A2r-»M5X>- Tcj Joflrn hov to ua^ ~" " 

*ppltf-Beft conflult the AT>plcfloft 11 HASTC Ftoaramaina B^tgrccict? 

Manufll (Apple Praduct JA2LOV06) * The ApplBBof t manual aasuoiefi yau ^re 
already EhdiJ Har ultli tlie A|^pl& II and ninple BASIC proftramairiAk If 
you're not Edviiliar vlth «Lthec AdiiuaE, vill wale li^rt while ycu I«rn 
dbtMiC che ApplB II, before golTiK on tc Leorn about 



Iven thdugh DOS coimnandB louh like BASIC CDnnandB. they do net AlWdys 
fulLmr the bhh ruLHB+ ^or exaii^lBp miltiple DOS ccumDandB can not b-p put 
On one linep Eeparated by cohobe^ The STHTAl ERROK meBBBBE resultsp 



SPECIAL KEYS 



W^3 

S^' "HI 



Throo^hout the naFi^h^l at^ JEaclTigs of prdgrans chac llluBcraco how to u«t^ 
VO^P Host df thiT&e prd^rams atc>- in Appleaofc; a fev art 1a InttA^T USIC. 

SoBetLmes the changcB needed to tonvvrt an ApplaflOft pra^ran to Itlteg^r — ,. 

BASIC are mentioned; other tlHB. they are not* Consult App«ndiH H Ifl thu j 
flppl&Boft m4nu«l Eor details on the dlfferenc^B lJ*t™en prograM written 
In Integer BASIC and AppleSoCC BASIGp 



A litcli? htt df hdiida-on ^xpcrlfiac^ Ib worth a lot readtna- OpE^e your 
diah driVF IB hrtctked up and the CQm^tcr t« turned cn^ Eollov each of 
these deaQriptions by actually trring out the ptOcedufDS on yduf AppLt TI' 
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Put the Apple tl into BASIC — tlthtfr Inic^tfr BASIC or Applesoft- Pl^ce „ j 

the 5ysten Hatic«r diBk«tt« iAto th4 drlvtF Tht diflVettc Bhould be ^2 
labelled WA^B 9fl 3 -UE - The UBt two dlfilt* ara indicated by it'*, HJn« !t ™ " ^ 

doeEn't Tuattnr i4iat tl^ey nre- If you have mere than ane drive* u^e Drive 
Thia B^ctlon ol chc manual only dfealti With Oild drlvr And aiBainev that 
you^ve Folloved the standard ccmVedtlona , putting the conttCpllar IdCO fllot 



Xlth the disk drive attached, end the dt&b^tte In the ilrlve, and the dialc 
drlv^ door clOfl^d* yon will find that the Apple 11 perfarms }uBt aa It did 
Without the dialtp Hothina iB chAnged* ft 19 as if th4^ 6i^k drive were ~ I 

not there» And, as tar as che Apple II is concerned, the dlslt drl%'e i _ 

not cdnnacrcd yet; a special coHvnd vst be Riven to Infom the coiqiuter pSTli.^^ 
that the dl^k drive and tbe new DOS Ins t r\£c t i ona are available. 



SoHtlned thia Tnanuai uses the curly bracheta i and ) to enclose the "^1 

UEHB of apecial keys which you are aupposed to preaa on the Apple 11 

keyboard^ — -- 



fRI-nJIH) mtant you aheuld preaa Iho Icey aiikcd "HemN". Press the RETl'HN 



(■KSET> rr-IU ptcBB the koy DurWd 'TtESET". If yoa fcpavE ar, Aufoflto rt »m 
m pr*» ol Eh- RESET key iiHl ceuBf the Apple to beep nr^ diapMy a prcnpL 
L|-ra.ilur. UKh [he old fitlH, a pri^SB al chc RESET lury will you IdEC 

file «I>W1T0R profirain. which uses ' w ICb priMq>t chflractor. 

iRSr.} moans pma Che key rwrted "ESC". "ESC" oriRlnfllly meoflC "escflpe", 
but ninifvddyB has othar libeb. 

tLTIU,) IB A bit dlfferenE' It means yov ehauH preaa the key macked "CTW-" 
fvhlch sCjiTld* fnl cantr'^LI and ccnCinul? haldln^ il duira while you type 
■ nortlPr hey. For BUHDple, fCrRL>C means type the "C" key vhlle you are 
hnldini dovn ihp CTHL key- ScoetlneB use of iht cnntrcl key iB Indicated 
In flnothPT Vay: CTBL-C and {CTRDC both TiiEflfr Ihe aame Ehlng, 

KDTE 

llhi^ractera Ijpcd Jille holdlna down the CTRL key 
do not appAELt ca the ncirceni 

BOOTING DOS 



Thf K^Jteafl of adding the D0& cnnands to [he BASIC In yokir Appin II Ih 
CKUed bocMflg Che dlBk, The rfJat be ft^d from I[neser BA5IC. fron, 

ftpplenDft or frira the Wonitor. Theie are VHllauB vflyn you CBn UBe to hooC 
nUS- ProB Tnr^Bor BASIC o, AppIeaoEl. the fRflfl and IWJn cormuindH fsBE 
your AfpIeBDfC mamiBl) may be uaed- Froo The Honltar. "conCrnl conniflnd*" 

l!™*nnS. ^'^Y^'^Y he used. Once g^l DCS hooted, U'a ^11 che 

■Wiv DDS: It dnesn t DBtter h-W you got there. 

In Che BRBBpIeLi below, the loWer-cai* letter S atanda Cor the nuirJiec nf Che 
Apple n (i]nt Id which your dUh controller card le locaLed. The atendard 
location tor the controller Eiird Jfl EloE at> (aee ChaptPr I, iTiatsllInE the 
Controller}. AflFC any of Che following caanaodB, you must preas Che 
RETURN ktf - 

Fro» Tnfiegei bASiC {whose prompt charactac 1b > ( 
you can ua« either at Cheae rnnBanHfa to boat Ch< diakt 

yov type: PRfp EMD^ie: ?IH6 

or: INN Emople: IM6 

Frm Appleaofl (uhnae proapt character tB J ) 

ynu cai> Ufle either oC these ooBunandB Co bODE the dltkl 

Tou type: PRia EifanplEi pitf( 

o"- Enample: lH#ft 

Prnra the Ndnllor (whove prompt character 1b * i, 
you can uae either of [heae conmandB to bool the dlaki 

lou type? [^rttfJC EMBipleJ C6g*C 

or: ^iCTRLlP EjunplP: fifCTRL}!" 
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Id the T^^t o£ this Banualp y«i dfL' U- i'l'^--^^ .1 t-t Ch« DOS In tlll# bUrim 

H vlll fllsplr IX>S^ or "bdoc the di4k"» Both upr«>Bli>iu 

Cmry popular abob coapiitar iwan)' hsd tbm «ataB tUni.- short, 
for thm nrd ^HCAtr^" nd th* t«n 1« fn* tbn U^ubIod *^ta pull 
OOH*^ 4p br oh'* lH»GflCrapB**p In mnj caH. It dd«» »C mm to kick ch« 
41^1 pm If rou da f4«X- In *udi m K4d m CiK t4 tlMr 

Hew try booting DOfl fvpii yotir Sy«t«H Hut«r dlslMtU* SCKt by potdu 
youT Apple II iu BASIC «lth*r Intfsac BiSlG ot AppI««ofE vlll dOi h 

aur* tht dlsWtta Is properly inserted. HMt typa 

And press the REHIRK V^y at uSuil - From now an^ It will b* unSBd amt 
yOu vlll l^reaa the RETURN key aftet H_^flcli [ n^: t ruct Ion ■ 

One* ycpti press the RKTintH key^ clie red "IN LJSF-^' will rome on^ the 

dlik will makt vhlrrlpi end cl^ckln^ nolaes <d&n't b« AUrned — it's not 

gAEtliiA nadT tA flj nuT> wid tn leu thu l# «ecoa^* « Hsa4a will 
Appur^ Tbm aiMiic should b« 4]:*ll«r to tin follDvliigt 

l£ TVa nflt tTJ Co v*a bASICp you vlll fliri that most CH^mm^nds still c^erate 
PDnwlLT tl^v Uida fron the TDeaaage auddenly appAAflnSp tK« Apple 11 «een« 
ttixd»ii|^* KM bu bq^nwd i4 thlat a fw new cntundo have bBBn 

introdiicad^ a&d ft* t>U «tf«4 Mv* hv upabllttiaa^ Tn diaosti b«A4 
ii«d« tbat an not ctrvioua^ honnri 

li Tha blHEH polnttr to Cbe hleheet newry locHtios y«* mt uaa 
has been feadt to accDHdata tht DOS pro^rflQ' 

2) tour Appla II aay have l9^t ^qme a£ ItA hlah-traututtoii 
araphicB capaMlitUtri dopApdlna hl cba bkudC of MWiy 

In jour coBput4V> 

** Vftr^lnna ot DOS that us« 13 sectors csn't he booted when the Bystem 
np<CtP 16 sector diskettes^ (The diak^tta aplns and htccupSt hut nothing 

cnaa 4ut>) X^n a 13 aactor diskettep update ±t ta 16 aactors with th« 
HDFm pro«ra«^ Tn can mlso w tbc BASICS dlakatta to b»t 13 aactor 

di«k«tt«« H ybar atxEaan aactn ^jstaB* Sa« Jhppndlx I t<^ l««r4 hav^ 

IF Boomio DWsirrwottK 

Lf you can't Snccesnf tilly boot yovr System Master dlaltatUt ra-raad th* 

manLisL carefuLly that cure* 9^1 of all problflW* 

This isn ' t likely T hul [ f ywr i\^it was shipped in a Sherman tflnfc or WPe 

suchj the coDCflctora Itialdft th« disk drive vy have workad a bit lo«t> IE 
jmx «rt U 4ll aqhUHlali alHut handling cbv inaljAa of your drlw^ jwr 
d«lar wilt b« ilad to dbwk, tt out* 

If y4U vj'n^ fl** ^i"a roar CloBcr^ into the worhs^ you cai^ turn th« cpaputer 
offf nda4boaiueE tba drlva frcp the controller- loH^lng the fdur 

fcnvB on Cbfl botEn ^ Eha drlva allows the ■echsniau to allp forward out 
of tlw caat* tlghtan tha unnKtora by pvitfil«t Eba aantly onto tbe 
circuit burdif 
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R€^~.i^i4|fcniln ] Mil- iinJt rtiid it ui ] t [^rohnhly nyu unjrk- l( thia flnt 
doesn't worh^ see your deaier* Don't fuke any adjustBenta* 

.mifUIIZHiO NEW DISKEniS 

Tl]e n^yBten Haster that c-i^m^-:] ch this m^nua I iR ,z ^ r - -.vL^clal dlslcattat 

Jt c^nt^lne prograu HinL ^iIL^hv yLHu to <:opy an L^ntir^^ d^i^kette^ UpdctCe UT 
diBkctt« that haa an aarli«r varaii^Ti oi DoSp and more^ ProEtua tbaC 
dasoHtrilta -varloua up^bllltlca of EHS «» 4I40 Included On tbn dl4kott« 
end dlac4ta4d in ch« wn*t- 

Take Ehp System Hasttr dlskettL' irom the drlvE^ and replace it trltb tha 

[^[hi-r hlank diskette Bupplled vlth your drive+ Nov? try an euperlinent* 

flt^ KjV^T r" j;oi npi , then type 
Pk f 

jnad wncs-li ijluit ii^]] pf-n . TKe red IN USE light conea on^ and Che disk drive 

iTuikeB a few clackeLy noises, then it Jcat k«apa vhirrine softly and quietly 
4tiirl U dc^^^n't ALOp' Yh^u'IL have to preaa the RESET hey to stop It 

(non&allyt chit la a BAD ±6aa^ but th^a^ circnstancea eren't nomal)^ It^s 

^d Idoo to opn tho dlak drlvn door b«£orv praulitt tha RESn kay^ slqu 
that urea tha baad of tha dtak drlvfl off tha aurfac* of thA dlakattfe^ 

tOiaB h^pcncd mn tblat 700^ II 4nt on a fnltlua unandljtg a*ucti 

(or titfonfttlon on a blank dlakattv (ob a claar dlak you can aaak 
fom«r-«^)^ (Aan a owm dlakatta la ■omfadtired* K conQilna no 
Infofiiatloii at all. lika a blank t^a porduaad for a tap* T4«rdar^ To 

operate In tba ^enpntA, tbera muat b^ npacltfl fnforutlm pl^c^d the 

rMik^-tt-?: thc^ diskette must be Inl tlallzed + 

It ynnu've been heepinj^ up with thf hanHs-cnn part of tho ex^mpLe^ your blank 

diskette ia In the drive ?ind y^m Jlp^,c presided the RESET key- Now taka nt 

Che blank diskette* rei^Lacc^ Jl by clit: S^ysCein rfaater diskette^ and c^OOe 
the door of the drive- Get the computer Into BASIC and type 

Pfi#6 

a£Aln» You ahoLild aft^ln get the iT«saa^ yoa ^nt bofora 4hatt you'boDtatf* 
OpM nrQ the i>05 conmends hava been added to BASIC* 

Tha INIT cc«4d can ba nud to IHItlalltta a "otaA^ dtak^tte* Slnve 

diakattea are mtH>r7-«laa dapandantt the size of the systea which 

laltiallrev the dlsk^tta datamtnaa cha £i££ of the system which can use 

the dl«kett<r« 7f a alav^ dl^k^tt^ 14 created on a J^K systeTHp then it can 
only be used on a syster with or more afccirirhry, ^?El ]-irf^rr t^y^temt, Only 

3^K ft( jntmory «1 1 1 be | . A' ti r irnTlslizlng a sla^e dd ^kp 1 1^-^ you can 
M^C ihr HA?iT>"K CRTATt: pr-^^.r-in (■h<-i? Th.ipter 5> fo tr-iciform )i->Eir ^lAi/t 
diwlcltc fntn £1 "ina ^ tp r" i^] ch- wh o^^- ]ini> J sl^I f -r i^t c inf. So that 
mrmcir/ J b m^^d i ^n^nt 1 y+ If "M I- F'l prop^ran w[ 1 ] -1 ! 1 i^nw yc^u ifl traaaf ar 
tliO CH^fltH^nf: fH( your 13 icctnr dibkcCtois to soctor dlEkett^n* 

The IHIT rtPfumflnd r^ulres the iise of a T^ASrc prciv.ram c-illcd ch^ "eraatlnB* 
prngrap «lnre it e^<=cta youi aach time you boot the diskette the pr(»Bru 
Vl1l ba run autoBB ticallr* ffie peetlnj; prograa fa comonly nAKd "HHfLD* 

hut you couJd c^n It 'lOKJOUP" or "KLTI^W? r>lAS'' ar vhatevar yha Ukk* It 
halp4 kwp llEe alapla to uaa a atandard nana for graatine prograna aa jrou 
IHITlallEa dlakattaa^ 



Sere's a a Cap*by t«p R^^*^^ >=° INITIbIIj lug A Bl«ve dE«)teCte. He naaiinw 
|H)S tP already hcGted as de bribed dbfrV*- 

L) Pwve ttiE Syaten E4aBter tzum ycrur dimk drive Afld rer^Ii^Ct it with 
A blank 4±taketce* 

2> Type NEtf* then type a grMtla^ progriinj Here la a ainple tAfnplo Ctl A 
greeti-qg ptogmt 

T™ Atmld supply ymir wn naoep apriteDi sltt. the current 
d«te ud DChet Ldfonatten to help you quickly Md caaily 

d«t*THiae the diskette's hlBtory and »l4Vt/HAteT atatua^ 
Tou uy TIUH the program CO Aba If Lt doea uhat you ej:pecE* 

3) Once the prDgr^ i« adtlaEACtOT? p type tbla inatcuctlDn: 
in IT }iFXA.n 

Uh«i yoLi preaa ttie REtlTllM kty, tlie dlakette wUl Ipln Jor Taeqrly 

a nlnute» nakin£ cl^ck« and little whlapery RcltfeB avtty 
no« &nd theop The dpproprlffte pcDapt character (e^g'* J 
Appleacfd Vitt bo dLapJ^y^d vheu CHlTlaltll tlcn la ccmpleCGF 

4) Utten tb« disk quiets doi^ti and the IN USE lieKt gooa ciff, 
rsniGve th*B dlEkecte 4nd label It. The lAbcl fihculd aay 
»fW thins li^e 

32JC SLAVf DLSKETTE CREATED 8 AUGUST 19^8 

BD that ]uat by looking at IL y^ kncm It ian't bl^nk^ 

FuC 4ald* ihe Syaten Master diskette aupplltKl bf Apple Ccmputer^ Put it 

vbere It ucn't be dandg^d by heJlt^ physical atreaa (kids? do^?} or 

umetlc objects. And vhor« it won't j^at l^tw It should bo tre«ted 
especially CAreEullyi since it cantaiitA tnatiy ti^ful pragraina- 

Onoe 4 dl«k«tte has been IT4ITlalized ^ it vlll be r^erred to as b slave 
diakacte- To labe] your slave diakette, you h£ld Co takr it cut tihe 
driTTB. Puc It back In and try booting lt= the mesAagB in your PBllJT 
atatenieBts flhouTd appear- If you fnUoved the mdfil glvtn abcve» the 
screen ahould asyt 

9lDCe the once-blank diskette nov cdn bcot^ you knou that it hns been 

INrridlized cOTrettly. From tbis pOinC on yo^ wllL uae the nevly 
INITlallEed alane diakeCltf for eKperlnientation ^ V™ canoot do anrnfe CiT Che 
procedures to b£ de lA 09 1 re ted below 4>n tbc EyEtem Kafitt^r, bfroau^e the 
diskette la 'Vrlte protected^, afi dlecuSS^ in Chapter A. 

If yob have purchaaed additionHl blank dl&kettesi it Umld be d good id#a 
to iniTialtEe a fev oE then nov. 



LMD-INO AND SAVE-MG WTTH DOS 

hocr the JiyiiLBH with your InLtJnll^ed dlakette* Typ* 
HEW 

to RLiki; Bute no program^ rtrt In DEmary- Tbia will er^C^e your ^reetins 
prnj^rdi^ Iwhlch la LOABnid iind RUH when you boot DOS) from moft&ty fbuC net 
fr^itn the dLsketti>)F 

Now type thlh niniple prcgram; 

V. ftCn LTKWI FffOGBRM 
IB Fffl? I ^ i TO IB 
^ P*fI«T J, 



HUH It Once or twice to make sure that it vorka you expect. In 
Applevoltp utieTi the prosran is BUH you'll this; 

For refereiiCD purpoae^^ call tbia prograi^ ONE TO TEh, since It councB from 
one to ton. To atore this pragrain on the diskette, type the inetriiCtifid 
SAVE flNE TO TEN 

Uhc^n yoLi coapJett the cammafid by preaalna Ch# lltLTlfRN key» the disk will 
whirr for a f^w aeconds^ 4ind the proflran will be BAved. 

IE you had typed 
SAVE 

Without uny aatM, the prO£r» would have b^int saved on c^iSftte tape, aa 
uflual Ifla^iunljig ydu had operated the tape recorder aa described in the 
BASIC Praft tanmina HanuaU . 

To prove that ths progran h&s been SATEd on dldk^tte^ do th* Eollcrwing. 

Firati type 

LIST 

then 

RUN 

to aee the proRrail it still in IMmoty and sttJl op^ratea proparlr- Thia 
d#flinrtBtrotEa th4t uttlng DOS to SAVE a program on a diskette doMn't affect 
th* program In any Way- 
How typf^ 
HfiH 
tlheti 
LIST 

ThDr<' will be nu prOBfan left flc oil — It di^flppeared when you typed SBW- 
Tn n-oJIy Tnahe aore th« ptogran ±p deadp turn off the COWptitet^ Tou can 
even trtke the dfakettt? out and put It (gfcntlyi bach In again* Turn the 
{'^■Bputpr bock on naain, get into EASTC and boot the COB. Type HEU (which 
i^i-aues the HtlJjJ prograa^^ oild then LIST^ E4orhirtB there? Rlflhc - 



Vow type 

LOAJ> OHE TO TEH 

mnd tli^ dl«k uLil ^bilrr for dbc^t tvo secatula- LIBT tht program: It Is 
reviv^edk R1TT4 It, and you vlll find It in perfect heeEth- TheL Id dll chetd 
is to SAVFIng fltuJ LCJAfliftS T^roarajriB from dlalc: It'a Juat llhe ualng the 
cdssette tape except tTmt a f He name 1b used^ and it^B Faater » 

CATALOG 

You frcareJ the prcHtt***" TO TEH cm your d^akette* AEtually^ ycu had 

dlreacfy Htored Another prf>graB- To flije ^mt pra^TBOiB are stored or 4 

given d]ak^ typ^ tfiE coiBBand 

nd a liJIt of All the [irogranB en the diskette vlll sppear. l^lght rtnv ycur 
dlakftttfi"! ClUlog BliDuId IddIl IlVe thlti. if your prourama vare vrftten in 
iPtAfttr BAEICi 

I l» HIE w ns 

Thft 1*tE«r "I" In Che l^lt calun neaaB that the pt<>£rdiPfi 4ir« In Tnttgcr 
BASIC: b^ftrrc naHS oF Applesoft programs ycu^ll fret bn '^A"- ?«!iJdeP BAI^IC 
prQEran filea, thf>t# art aIjo Qthsr klnda files that tdn stOlTcAi ^nd 
th^y Wi\l b4 explained in GhaptDrS ^ chro^jgh 4» The nundscra ofccr chP 
File-type Ittttr represent the lerfith of the stared prc^grdm- In this 
cAflBh BffZ diskette '^mectPrs" ware required ta store the progrdifp F-SCh 
dlsketre sector can atote up to 25^ hftt^ cr( ] oru4 1 ] an « The ahorteat 
pcaAlbie file, an empty text file (fiev Chapter b) ^ t«cLuires >0I Sci^t&t to 

record certain "housekeeping" ifif crHtion^ In eUlh 4 diskette can store 
496 se^EOrfl prPgraHP^ And other flTea^ Laatly, each entry in the 
catalog containa the nane of the proern[^- Bee Appeadiy. C for details co 
ho^ iivE^nutisn ia atoned on ttifr disk«tte«« 

When d file ««ceedA ?55 sectors, the length reported for Ch^t Elle by 
CATJiLOr; starts over a^sin at fW^' 

There la Ho way to telJ froo lo(]kin£ at the CATALOG which pn^grajri [a the 
gtecting ptdBtaAiP So It help* if you always th# »w to ycur 

Ereetlng pro^v^^ 

ScnietiDes you'll hsve oAre praj^mmp on a diskette than vlll fit oti the TV 
screen at one time, CATALOG ^ill cause the first Ifl prOF^rsma ta.be 
listed* When you're ready to aee the ather profirantB on the Hlsht^tte^ 
pre&a any key CKd^^^t the HRSLT kay^ CTRL tcy or the SHIFT beys* 

WHAFS IN A NAME? 

Flic njiw^ nuBt he from 1 to 3& characters in leneth; DOS will trwncflte 
longer file ncimeC to !)0 diaractarS- A f Ue name nufit hi>gLrt with a letter* 
At^ typi>able character except the com™ < p 1 may appeer In the iiakA- 
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Herp are some it^hl Elle nanvsi 



BOHHAMRtll-lSTlCS 
tlhE TO TEK 

THE DIIAI.ITY OF HEllCti UHSTftAIPED 

Here n few names thflt will noc wdrk (and reasone why)s 

I TO 10 (bejins wlLh a digit) 

Kl THF:nE. UAKIl (contains a comioa} 

lUErr EXCESS V^BTAfi^ DISQDALIFIES HAHES (will be ^tut Co 31 cbidractets) 

Although the name or the Ust file Will ha cut to it ghar^ctcra vhen 
displayed by CATALOG^ you can^ II yeur (ingecfi cian take It, type the 
entlte nape when lASADlng or RUNning, and all Will work correcitly- 

Every fine tn the catalog represents a "file"* Th.^ BASIC progrdni you 
atnred I4 an esflnple of a file- The mTaa given here for file nAQee oEso 
apply to rhfe oaioea of pTO£tam£» 



ft e4 control chqr^lCter Is accidentally (or evto purpOSefullyl typed into a 
name, that character will not appear on the screen when you get a CHtaiog. 
For eienple. If 70U type {CTRL>T instead of plain "T" In the nwne 
''^ATHA"^ the cntaiog Hating would appear to be 
AllAHA 

However, if you tried to LOAD that file by typiog 

the coaputer Wtiuld reply 
FllK TfOT FODNP 

avcn though the nane V*" typed geened to he identical to the nsne in the 
cetalog. Ed he c:flreful^ don't inadvertently puE conttni characters in 
rile namea- tAlthoughj hch heh. It's a clever way to keep you out of my 
hank reccrrdd if all riles have secret control characcera embedded in 
thcDi^..) The File Kbdeb section of Appendix F contains tips on bc»w to 
find 9ut idiat control characters are inheddad In Clle nadicap 



neiAME-ttlGFILfS 

tor one raaaon or another, you^Il occasionally want to change the aue ot 
* Hie- Suppoae ypu get tired of typinfi the file riane DUE TO TEN and 
detlda to call thti file COUHT^ Ju^t cype 
REPJAHE ONE TO TEK. GOUKT 

find after A rrwment of whirring you' LL sgain see th* flASLC prompt 

Lhnrn^ter* Now type 

CATAIXK! 

to verify that all went a« plsonedp 



Jh^ HIJNMir cDDnmnd does not check to aee whether the neb naoie you're 
Mfllnit already ettista or not^ flo lt*a entirely poaaible that you can HfNAHE 
until oil rileii on a dJakette have the asme nuc^P^a moat undesirable and 
conruulnil slruaclcin that is best avoided* 
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DEl£TE-ING FlUS 



It 1b eany Co remve files ftm th* dlntettB, Type 
CATALOG 

Tl^Ain to eee the two tiles that are on your dlatette- Km typO 
LOAD COUrfT 

(oftSUhlng you chflnged the file name na aTiown dfaovel to get that proBCafc 
Into nHiTDry- FJclcCe this progrdn fron the dislcEtCe by the iTWtnJcLioo 
DEL-KTE fl&UWT 

and teat that your delation haa vothed by tyi>lD^ 
tlATALM 

Urilv the HreeClriE ptdgrAfn probably calEed llHlJdD — la left- Slm:e the 
program CDIITIT la Jn Hmory IchFlt^? rfiy you LOAD(!d Hit jrou can place It 
back [jntD tki(r dInHctte with the fdHlllar di^nvund 
SAVE COUNT 

Take a look aE the flfttalofi to ace that Che pragre" la agrtlTi Ofl the 
dlaket te* 

If yuu t" Ha DELETE d file thpt'a not on ch« dlvlcette* you'll receive th* 
FILE HOT FOUIID 



RECOVERING FROM ACCIDENTAL RESETS 

Suppose you're withmt the DOS in either Jnt<;per BASIC or Appli^floft- (If 
Appledthft Ifl In flmvat^p uc ^eauine the aWlEch Oil the card la act for 
Applesoft)' I£ you accidentally ftcrlke the REEFT key, you Crtn retover with 
your pto^rAH Intact by ualuR CTW.-C:- Th^ DOS alao has recOWty pTOCedurea 

th«t will uaually prOflflTVC your profiran and ddtft- 

If ycxi are UorhlOFr utth an old Honltdr POM and have already booted DD3» and 
theti preaa HT^SET, you pet the Monitor ( * ) proapt* To TCtum to DOS and 
the BASIC you Jeftj type 

R««Bher that's d Z«r?» not the lettl^r fl, between the tetters D 4nd fi* 

If reenvery to DOS dP*a not vork. dnd the prograH atill LIST?» all la not 
Icflt; BBve the pTOgraoi on tape (y™ did reoeiier to keep your tape drlv* 
for ]ufiC auch an esnerfiency. didn't you?>- Theo at your lelfiute yoy ^fln 
boot UOSi LOAD the proJirfltn from tapE, acd SAUF It on a dl»k4ktd- 



If yml adCldtntfllly <nt lut exit tone llyl hit the HKSFT key while tht dlak'^s 
red ^*Tfl USE" light iM 01i» the InformdtlQTl on your dlflkcttl' may be 
clobbered* Prohlemrt dre inoat likely trt occur If thla happcnA when you're 
puttlDfi InFormatJQO ontn the dlakette ufititfi i1 SAVK, BSAVF, or URITE 
CofTTtTHind^ In the ev<^nt that It 1* clobbered, ytJu probably won't bo JlhJe to 
recover your pmurama froni thr dSakette. If nothlna elae wotkfl, you can 
re-lnltl^ilLze the dlskrtte and use it ngj^irip hut iraiTlfl J UlnR cJestroyfl *J1 

th« fllea DTI tiie dlakette- 
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If your in Lifit light at«ye on for aev^ral ninutee bat you dcra't h«dr tha 
uaual dlak sciiAda^ ymr By«t4D uy be ^^UOa"* PresatPB RESET nay he the 
cinly Way to turo off tlie light 00 you cait reat^rt the ayateop 

A dlJvkrltt" C4in be p^rtlafly clobbered^ so that It Vlll not bodt- HoweveTj 
Ln Nuch A f I rcunatance, you can aome times bo^t dnOther dialtet te, then LOAD 
prograHB froB the partially rfobbered diskette and £dV^ then on an lju- 
ddOAged dlakette^ Or uae the fJD prour«u to copy Individual flleB OT 
proRT^U^ 
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Ik Syntax 

EnlT 

LOASp RU14p and 5AVE 

2b Hming between LaaguHgefls IT ^tu^ 
Z» Uae of DOS Trmi Vlthtfl * ;fra|t» 
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DIttVE, SLOT AND VOUIMC OPTIONS 

no«t DOS ttRnmanda aILm you to BpGC±fy m nOBtptr of optloQB, aiicili which 
diok drive yov art ufflng* which llac coDtnins Che dlBb concrollet for that 
drlvcp di^d a "volune numher" for the disk* 

The diBt drive option sIIewh you to operate with BDre than one drive- 
Eoch CDOtrolltr hafi the ability to contr^nl vltlier one or two diqlt driveOF 
Norsially^ iaatructinn^ refer to drlre 1» Thin la the deEjuIt drl.vc 
a«lBcit.ioii: if you doTi*t specify a dtlvcp drive L will be used- If 
wish ta specify drlv« 2, you uae the nnt^tlon tfepdrited Etom the file 
n^H Or Other diah optiona by d COamaF For example, tc» InltlaliJCC A 
dialtette In drive 2. you cotild uA£ the InatructioD 
IHlT HELLO p DZ 

Aft*r drive 2 ha^ been 4pecifled» a[l fur til a r diak coMaoda refer to 
drive 2 until rfrlve I la aflaln apectfied- Drive ? ia nov the default 
dTiV4* After the above tNlTialiEatloTt^ the comdnd 
CATALffi 

will !i?t the f[le* fttcired on the dijkette io drlw 1- Tc specify drlv« 
I, 7DU use the ootAtiOd Dl aeparHed fron th« tile itne by a comu- For 
ftndmple, 
CATALOG, Dl 

Vill ahov ym the COoteotP af thft diskette In drive J, and ^hdnge the 
default drive nmbei' bacb to 1* 

I£ aote than tvo drlvee art lo uae, then add^tlonel controlterb are 
required^ Theae are placed Ic different aLota thac^ the first COdtrolIdr 
(which la cuatouriEv in rilot niouber bi m You can apecify flLoi tt 1^«ro n 
tQ A dl^it from 1 to ?] with the notation SCrp^rdted from the file nanie 
□T other diak optlOflt by a cooma. Far exviple, to initialize a diakette 
In drivt 1 aiLdfhcd to a controller In slot you VOuid use the 
ina true Eton 
ISIT RELLOr S5, Dl 

The file name no^t cobe fir*tj but order of the options 1» not i^otcdnt* 

Tbfl default slot dumber Is the one yda used vhen booting the DOS* Once d 
dlfleraat 4lot mmber had been apecified^ It becomts the default slot 
atifflber udtll it la expllj^icly changed. 

AftAY ualng a DOS CMmiind with a Slot pdrsiricer daaing a alot that doean^ L 
dDPtdln d diak controller^ you £4t dd 
I/O ERAOP 

Afrsaa^e, and alJ appeara tn be fine- But DOS uOV thinkB the default slot 

aurber Id th4> bad alot fltinbcr. and that the disk that i^n't connected to 

th^t alot ifl gtill Tvnnidg - Even If the next MS copuMnd f^petlflev the 

right alot. it waits in limho forever for the ti Oo-pkIb ten t disk ta 

Btop mooing the list command. If you have no pragraBi in Bwmory tKdt you 

q^re to eave, simply re-boot DOS. To recover Vlth yuuC program intact, rfn 

this: 

1] Heaet the d«fdult alot by typing 
CATALOG Sb 

^ere B ia the corrent alot nLipber- 
2) Uheii the ayacen hengs^ praae the l^ET key- 



3) IW 

Jind all should be fine agaia- 

IX>S aiiB t be huoted frooi a diakette In Drive ^ not thrive Z- 

Thc V0[Lnni3 numbtrr Option Cdn te uaed to protect dlaketted ftOtt being 
accidentally written over. For ndmple, suppose your have d 
dlakotte-b^aed inventory syateDr where each month's rvcorda Is on e 
dlElerent dlEkette with a unique volLiine uumher. Then whed you go to enter 
Infonnatlan for the month of JMuary» you niat be sure to Specify the 
corrart volume number- Otherwise* the inforv^ttori won^t be 4rritCdn LO the 
dE4kette and you'll get d 
VOLUHE HlSHATCn 
meaaage * 

A ^'voEuTue number" may be aaaigned to a diskette vhea iC Is IfFlTie 1 1 ZCd i 
uaJnR the nocdtion Vn Stpatatdd frMl the file najne or other dlak options 
fay a coniu. ?or inpt^nce* to initialize a diakette using cbe njiikie ^'ETART 
UF" for the greeting progrdm (tho program that ia run each time the 
diskette la booted), uhere the diakettE ia In drive 2 of a controller in 
alot 5, aapij^ninil the diakette a volume number of 12S^ you VOUld uae th« 
coirmuind 

IHIT START UP^ D?^ VlZfl 

The volimc itumber of a diakette may not be cbenged vltbdut re-ISlTialialns 
the diakette. 

The drivo number. Alot number and volume number OpClOdO Tn4y appear in any 
□ rdtr- The dbove co^and la equivalent to 
1T*[T 5TABT UP, V12H, 02 
and to 

IHIT START LP^ VUB, DZ 

and so on- 

The valune number uf a di^bett^ miiat he an integer from 1 through If 
no volume number iM upecifled idrth lENIT^ b default volume nn^bAr of ta 
dSSigned to the diskette^ 

Tlie coHMnd 

IN IT HhLLO, 

d0Cri not give any meaBage^ hut aaslKus the diakstte the default volume 
number 2^Um 

All DOS cnriEoanda ran apeiiify the volume number, it you vish DOS Co check 
l\^^t the vtilume ttuvher m the diskette agreea with cht V option- If you 
do not 0p4^clfy any volubtt number, or if you apecify volume tero. or if 
you type "V" without s nuHber, POS "131 ignore the dlakatte'^B volume 
r>umber« If yOu dccidtmtAl ly Specify sn incorrect volume number, the 
synthm Will reject it vith the meaaage 
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Wolume Dlsutfb erron CHnnQi oceiir iiti«D yoa » «ea tlw CATUjlG- la 
caae you i#iflh to kuH the vDlDH DiBibvr of diakatu. It la given j>t th* 
heed Qf th* CAtALOC Hating- 

Additional dlacuaalon oE optiona la foiud Aen ucb ccammd le 
IntrodbuJ. UiO| Ebe infoiAiaiion I9 conclaelr Hi^HriHd for each 
cQBMnd In tha C mn\ 1 BumiMcy Appmdiji nd oa tlia QoIcIe Hafariiu:E Card 
BCHHipaii^iifl Uiifl MDnal. The followlii^ Motion aiplalDS hov to liit>rpret 



SYNTAX 

S^^nE^ rElectt Eo the atiucEure of a CnpuUr CDHad, <hc ord« and 
coEcecc £ocB of ttae cdhbuuI'b various pnt«. A eimple natitlon ±b used to 
deacrtba th« BTntait at «aoh MS cDwid. items in bracketa a and J) art 
opIlanalE c^EIddiI. pait* of a DOS coAMnd may be epecifted la any oEdet. 
CAPim Uztna and cmaa noaE he tjpwl an thani lovn caaa Uttm 
■taod for ttana you wat itqiply. In BpaclfrlnB ■jntai for DOS 



C atflodB For a fil,- n.imt: 

d ■taoda for drive number — either I or Z. 

■ Standa for aLoi nuaber — t rhrDugh 7. 

V BtflTida for valume number -- t lltrr»u£bi uaually- 

A diakatCe'a voluu* □uatwE' ma; not b* tm SpecUying a 
voiuH nn^r of # in ■ dlik CDHand l« ■ "Sdld card" that 
EflUa DOS Ed ttnora Eha valnm nodiar on Eha di^iettV' 



UdlEloq*! abbravlBtloH uaad In rhit wuul ara anwiriied at tfaa atacc 
of Eba CoMnd SuaaiirT JtppMdlx. 

Aiqr nuHSrical CDDStanc [tba dvlve nuAart valnu itQidwr» «tcO in a dob 
rnnHDiid can ba npraaiad tn haudaclKL flOMtloa by pracAtJing the heif 
diglta aith a doLlat itan. Jt you don't knnr iifmt baudnelval natAiiDn 
U, Ignora ^ pncndliia atnttwat — jao naei't iBdantand bex natation 
EO uodentaod (his BaDbal. 



INIT 

Th* ayntai lor the lElT conmaoS 1b 

ttiT e UVv] t.Ba] LJM] 

Minra tba biackati iDdimte optiona uhlcb iipy or mf not ba lAcludBd- Tbm 
azun^a 

niT HBUJJ, 717, Dl 

can ba InteEprettd aa fnlloBB- 

The coDiinand name "THIT" la In upper case, athJ r.n'i Hyped e:f9cC(y 
■tiOWn. The lower case "f", fat file nenie la teplEiccd by Ibe I eg : i Ima I c 
file oane hello", Nenc the optional volume number I1 Indicated: first 
vvHi a CDna, then the upper case "V", The "v" ior volume :^L.mb*r was 
arblErarily replac*d by [7 £or thla eiaiiple- th* bcacfceta around ",fiA" 
lodicata that ipBclfrlnft the alot eathvi £■ optional fne Eh* MIT cowndi 
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in thlt w^la IE'* OHlCEAd » DOS will uaa tba dafanlE alot nidtn- Tha 

4rtv* ocElon ta Lnclndadi tba cooa and ancr caH "D" ant ba ■■ abcnm; 
eh* Ivnt "d" ii raplaud by 2 In thlt nmi^le. 



LOAD, MJN AND 8AVI 

l.dADInj^H RUNnfng and SAVEIi^ pr^grwns on the diafc ±s similar to the 
£ Lht-rr-t^pE^ndine cperatlCHid ufllcig thi CftSOette (except that pTD^ranB are 
rafcrenc^ by fllA aamI^ EvAtythlofl goea ftt Icftst ten tlioea faater^ And 
fom nmv AHd E4 pruB buttau to plxj^ Ttqtffd or t«ifliid< It Ifl 4U 
MQfOUtlf* th«r& ATA iMSf Addlttcnul dfrlUtiM Eb4t thft dlflk bring* mm 

wfll, ffuch dft ttie catalog of prograpu and ttw HCoHdc running of 
Firo^raDiB without UBer intervention- Saving datA (ofl Cut Clles — mmm 
flhflpLtr fi> 1e ^JftO very eany* The FID proRrm detCtl^ed In Appendix J 
oifofm you Ri^me ^ddl Llonal vaya to manipulate filea* 

It's aH>nd irfea to hatifi on Co y^njT cnQQette tape system (or tradins 
progtATTTa and as back-up storag* for vital propaaa and data (ftltlwu^ 
»p#rlMt« shows that disk storag* 14 «vca wn nlUibl4 thim C49a4tt« 
atora^ qI pregrnq dAta)i 

If ftm haw « pns^u In BABIG^ apd 7« viah to call it HEm. Ihn Ch4 

ceaMud 

SAVE rantT 

vfll aave it on tht dlalxtta* If you Mva ura than oh drivai HENRY 
nnrullr would ba savad on tht ^rlve frwn which you boated DOS (the defult 
drive, Linlesfl you Specified a different drive after booting)^ Tou can 

ap«tlFv drive nutdn^th volana nuDber and alot tvjBfcar aa vith the IHIT 
COBBand+ For ExsnpLep to SAVE 4 Cll4 ullad AGATBA Ott dElva 1 oC tha 
controllct Ln ^If^z 2, when tba -mluB miAer vt tha dlAVfiltft 1« 2l4p :ron 

could uae the coamand 
SAVE ACATHAp Dl ^ V214 

Aa beforap tha thr« cptlons can hc p"t In any orLi^r. If vou had omlttecT 
th* VOLUH HiAer opttPQi AGATHA would have been S^vr-d thp ^aotEj bleaS 

hUi but DOS wnld DDt tim i^ecked that Lhe diskette WA^ hT>LLLTTtC 2L4« 

Fngraa DtHb art A4wa, ai^ mat follow th« file nue mlnsi tb^gj mj 

b4 «p fcA M charutan loagp and Hat atnt Mth a l«tCK^ 

iBclttda nr dufKtan yob cm tyiw «x«4p< c«iiua ot control cfaancC«n> 

Bart Art KM valid mamm for f Ilut 

CHKKBOCK 

TU QDM'LTI OF HftCt 
1I1HEB14 

VOHt UAA TBtHI 



To LOAD a progran nained ACflTHA* use tht^ rommrtnd 
LDAD AGATKA 

and the program of that name p If therc> Is r^nt En t tu" C ri ] oj^+ wi 1 L be 
loadrd- Tfl (fqt If AGATHA is loaded, shti: at vtu- -^-an w.-^lk a straight line* 

If you want AGATHA to HUK after aha^s LOAOad (poor thlngj you can^ of 

enntt Eh« coppanda 

LOAD ACATM 
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LtieEi 

Hul lh*rc'fl * to do It In juBL dus sLept 

RUU ACATUA 

iB d DOS tomBnd that tirat LOADq the Bpedified fll*, then ITffla it* 

Here's the ayntax fot tbt BAVE dtid LOAD Add RUN coRSunda: 

3AVt t I^Sm] [,^di t^Vvl 

IhOAD r [,Se\ I^Dd) I^Tv] 
Rim f [,Cd1 

SAVE OUR HAPPY UOHE, Ql^ 67 

U>AD UP 

BUH AHOK, S7 




ifp ^hER you try CO SAVE a proar^Tn ^ set b byhtaX ERROR mtiuagei 
either you have Bade a typing oriTftr, flr T»S Isn't boDted- Firsts try 
re-typlng the caAnandp IE DOS wat cprl^tnallv hooted^ ass 

to tt7 to r*CO¥«- H 003 imn't belted — DOH^t BOOT IT> Boottpe DOS 
will eraflE ddy Taroj-rwi trk HfflftPT^ - Flr^tp sdve the proRram on Cdp*, ulln^ 
thn LiEual cdSSfCCe 
SAVE 

command. Sow boat DOSp ^ext^ use th€ uAudl {zdtttttte 
LDAP 

cnmbaud, 10 bring the prOfiraDi bacit into ynur AFFL& II '■ Mmory Iram the 
tape- Hav yoLi vill be ablfr to SAVE It an didlL- 

ir d diskette iM bad {perhaps qnaieoiiE tried to atapla It inLQ A notebook! ^ 
nr If the diskette Ifl not InltllLiKed^ or IF there la no dlAk*tta In the 
drive, or If the door ia DpEUp the meAAd^e 
I/O E3LRQR 

(I/O Stands Eor Input or Output^ vlll appear wbtn y4>u try to SAVE or U)AD 
uAing lU^. Cl^eck «1I the item listed, and corract the problea^ Ifou 
dnn^t need to rd-boot DOS- Try Agaln^ 

If you uae tliE cOfirmdnd 
LOAU HtNHY 

and HENRY ts not tlic nai^e of a pn^grdm on the dlekeCCe in the drive, then 
you get this iDEfiaaee 
FILE MOT FOUND 

Look i^t the dlakette'^a catalog to find the prograin'a Enact filA ddne- All 
characitErB and cpaceB kruac be typed euctly U they appEar In Chd fil* 
Ti^EQE ahDvn in the cdCdlo^- 



DOEIC 

To tfllBidata Any file th^t you vould 

pomdnd 

DELETE 

C4d be uaed. The ayntax is 
Dll^K I Usui I»Dd1 |,Vt] 



rather not baVd on your diskettE, the 
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For EunpiCf the canmand 
l^t^lTG E£t^£Sfi, V3^, D7» Si 

d^taCl^ o file nmPd EXCESS froft a diakettr th volume nu*&r 3ip which 1b 
plated In drivE 2 of the cnntroller In alot I, Sectora on a diskette dr* 
"qet Fred" only ^En a FLle id DELKXEd^ 



A SCENAIIIO: BOOT, SAVE, DUN, CATALOG AND DElfTE 

Suppnoe ™'rE running Integer BASIC Artd the SyHttB Haater dluVttte ia In 
your disk drive. Hero'i a Sialog aS it IPlaht apptdf 00 thE actrtd of your 
AFPl-E II. Th* p*rta you type bee underlined > although they dn not appear 
tb4it vay on the TV tfCTEEn. Ftret typ^ 

to cUar the atreen- Vou'^ll see thE tollowln*i 

*4 U7 9]t«W 

-m Ai j4ptyMbit 
m ei PHf.H. List 



P^^C^T- ^ ^ ^^^^ ^^^^^ ^ 

■ i_^t^->j Slave diskette you INTtidlUed earliei 

r^V^ ^'tttiFflfr' ir"^ qlnce it it OOt vrlta pTOttOted^ ^ 

3 rt^ -HfcLT P , 
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F H£ COMJ 
^« m Otfi ERIE 

>^ 

>l*£t£l£_E6S2 

MOVMG BETWEm LANOUAOC5; FP AND JKT 

Euppqp? you've bB^n uBing Entegtt BA&I^* and you dEclde Ed vrite A ptCpgrnTn 
In APPLESOFT^ or ta liEc the cornputei: d£ d CJilcuLaCQr vt^h flDating point 
minbdrB (flunlierB with decimoL pdiuie)- To lf>iicphe APPLESOFT without 
clobbering DOS, typ^ 
PP 

(that'^B all there ifl tfi Ic) nlfld In » few secondE APPLESOFT will be Up 4ind 
ruiming- The FP stftpda for "FloatinB l^Olni", of tourae* iTf for boDk 
r^sdtin ApplepaEt isn't availBblE? — it'& not in flrwaTe or on the 
diskette tKet'fr in iwe — then the meEBHEe 
UI4GUAGE KOT AVaILASLF 

vill be dlapla;ecl«) The ttynCdX ioT th^ cctmaed is 
F7 l,£»h IpDdl 

vhefe tbt optimisl Slot ^nd Drive paraKtetb dllov to to Specify the drive 
coDtaiHiilA Ap?ie0c£t <in « dialette. 

[f you've been uQlng APPLESOFT dud DOG. you cin t;pe 
PIT 

(tor "IilttBCr USIC"] to return to Integer BASIC vlch DOS intACC- The 
EiintB^ for thlA ccmnand ^In^ly 

ivtr 

vlthoLit any ^araDctetb* You^El gmicrdt« S 
SYTfTAX ERROt 

HBEa^ if yau Lty to U3e the D or S parameters with IHT* 

<Si 

II yoii type 
WT 

while Ic Irtteatir SAglg ^ you will lose any prDgraiD lEi meB&ryp SlnlJ-arly* 

if you type 

FP 

while In AppleAaFt , you'll 10A« aoy pro^m ill ncMTy* 

Uheit ynu Ewitch Erooi EotEKct BASIC to AppltJaolt OT vLce veraa^ you'll 1ob« 
3tiy pro^TAtn yon happen tD have in WTUDryp 
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Iri rtddlM[>n tn mcivlntl back and fcrth betveeo th« Apple's BASICS, you uy 
Wlnh to enltr the htonitM and be ablb to use DOS COtuHnds. To do M from 
^Jlhrr Applr»oft or Tntfrgcr BASIC, type 
CMX 'I SI 

and ynn ffhou14 8<-C the Nar^ltor prompt character^ * ► To return tp 
wlilchvvPT UASTC you Started fram with your progrpn and DOS intdct^ type 

FruB the Monitor^ yoii DU" alEU type 

rNT 

in return to Integer BASIC, nr 
TP 

tij rpLurn tfl Appleaoft; In elthec case, UO^ vlll fltill wort but any 
jr pjirapi In Mtmoty wlU hflve dlSflppoared . 

Tl you ^et ji 
I'MffllRAM TOO LAftCE 

TTWFJBftge when trying to execute arc 

*roraMTid, typt 
INI' 

fJtQt^ t& rMBt the ayptablv Then typ« 
FP 




t;vtn tlioufh your diskette Ctmtdina the Int^ber bASIC proAran napied 
APPLfigOFT. do not typ* 
RUN APPLESOFT 

If you AppEoffOft will ?eejn to be runnine fine tintll you pteBB REBET^ 

nay, and try to re-enter Applesoft. Then, since the DOS thinks you *r* la 

Integer BASIC fbecatise APPLESOFT was an JnteaCT BASIC prDgraTn) » you wlU 
h(^ J.n trouble. 

To Bov* the APPLESOFT proaram trOB Oflt diskette to qnoth^r, Binply 
liMD APPLESOFT 

rrop whnttlrer dlQltettch If^B then pldce the diakette yqu vlah to 

^^ntdln Appltf^oft In the drive and type 
3AVE APPLESOFT 



USE OF DOS FIK>M WTTHM A raOGRAM 

V^ry uficn H'b uaL'f^hJ t^ Lk- able to execute a DO^ conund from within a 
JiASIC prc^praDk Fur eXAmplep ynu nay wJah yo*jr grOtfCing progran on A d±ak 
10 print <TUt the contenttf ot the diBh by doing a CATALOC ce^maucl- M«ny 
HflEh conTHnda c^ari h« entuted Iron ineide a BASIC pro^rdBp This la done by 
fhJNTJnR a ntrlnft that ronQiats of n CTBL-tJ folliTwed by the cnomand. 

licTt" In dF> Appleaoft priiK^'" that^ If uaed as a (treetlng ptf^firan, wJll 
rauHt^ the Infcraatlan In the PflLNT ut4teHnEi1 in llnee 2t anj 10 t" nppt-ar 
mi rhfr ncj-ffflnh ft?l]owed by 4 tiel of E Lieu In the irATAIW- 
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9 OKETiHc^ F«a»m 

IS CTRL-P 
ST i?p<3^ 

^ L 1 f" I ;i 

Tho moDBended va? to do this In Applesoft Is lliuAttdted in the abdVe 
program, Flr^t the acting Df, CDDtilBtlne only af b CTRL-D^ Ie Qreatsd 
ufiing the CHR^ function Jn the £lT«t line af chc prcgt^. Later it c«n be 
uBad as In line ^0 
ikt PRIHT 05; '^CftlALCK" 

Vote the semf.-CDlqfi After tha D& dnl th« i^udtatiOn aarkb arouiid thfe DOS 
canmard- The aehl-CDlOn Id Cptldndl in Applebcft PHIKT £tat««ntA» SO If 
4 pro^rdm has man? DQS co^nioard^ in PPINT 9tattbents, ydu may find It savu 
typing tine and Vfflory Spdcze tc BlmpEy onit theiOj and ugb the £om 
40 PIT NT &$"CAT*UW" 

In Applesoft, you CAn uan the CHRS Euncticin to spEclfy CTKL-D 
19 l>$-CHR$f4): REH CTRL-D 

Bhit ]/Ciii need to recall th^L the ASCII code for CTRL-D ie 4, flo a REHarh 
uy be u&e£ul» {Ttie CHRS functlan not PV^lLable in Integer BA51IC«> 

tn either Integer or ^pluoft you Tuy d^Elne CTBI^-D by 

typing the cherdcterA 
DS"" 

Chetl typing the Letter D vhile holding dava the CTV. luy, and then typing 
the quE?tat[c>& narhr TfaE« that chb CTRL-D Jnga not nrijii oa your 

TV acreNi The final cciHniand viLI appeat aa 

Elnce control characteta do not prints it'a often a gaqd Idea tn follov 
vith a REKark. to remind you of uh^it actually !■ io rh« String- Here'^ the 
above progrfiil WTlcten in Integbt BASIC] 

» PfflNT "BV mV MWKS Oh O RUOUST 

Only 4n«i JK9S CEiranand may be used in M ?SII4T SEdteHnt* The PRINT 
Vtatement must bOftid Vlth Cbn CTRL-B aad ead vlth the D0& con^ad^ 

Ohinj the rifht-arrov to topy a HA^IC atatament contalnioK an ifivlaLble 
control character will eraa^ the control character* 



3D 



In MS c-OHands axecutiH] by a program, the DS fl^at be preceded by a RETURH 
nt It Hill hfj 1](nDred« RUNnlag l^hia program 



lO W ^ Iffn TWEPf IS IW 

I^ltt^E CTIJL-Ii MT«E£N THE OU 
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V L [ J ^auae 
TESTCATALOG 

to he diaplayad, since the semi-colon fiuppreQaea the RKTUIlIi At rhe ead of 
the HINT coniaand in line 20* Tc correct thia, and ^auae the OQS camnand 
CATALDC; to he eKecvted uhea cht prP^ran i& RON, JUBt delete tht flepil-CDloa 
frDD the Odd of line 29' 

The^e DOS coTmaanda AhOvU only be ubdd viLhln progran in A fB1T4T 
atatemrnL bejlnping with a CTRL-D; 

OPRN 

APFIHD 

READ 

VRITE 
POSJTTON 

Theae DOS ccmomndfl uy be uaed 
Vlthin a program using a FRIUT 

CATALOG 

SAVE 

LOAD 

KM 

DEICTE 

RETtAHE 

LK¥. aad UNLOCK 
E-fON and EdOHOF] 

s 

me DOS CiCnMAnd HAXFTL^^ nay he used aa da^ciihed abo^fr in »n AppleSoCt 
programi hut It nuflt he uaed in a special way ft4k an Integer BASIC 
prORr^fft ee diacuased in the section about rhe £KKC coDBand in Chapter 7* 

TliT [HJJi cPiTWnd IHIT ahould he uaed only in Imnediate-e^ecution »dfl 
{dlr«i canfieqi>enceB may result if you Ig^^^ thia ad^nltloil)^ 



In iuHdIate-executiOil Hdr» and al«0 ITOm 
Qonmand with CTRL-D: 

BSAVE 

UAAD 

«m 

EXEC 

OlfDSK 

m 
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B bi- 
ff N 

eh 



IF 




CHAFIfR4 




3j wan 

KEAttAtLaft Idunwlf i«>UiWC Bl^Mtiai 

iniKi fh* eon rujpHB 



%1 
» 





Two Viiya of protecting y^U dild/or ytnir dlakettea aBdlnst dJqAqter havtf 
alrcfidy b«D mentJonad- Cbdpcet 3 HntloDa usic^ the Vciluine option to 
eneiird that yoti pJicc Inft^tDatlon on the desired dlakttte^ Thn uae of 
CDDtrol chAT4X:tard Id flip nAmct can sIeo be used aa ^ VAy d£ protecting 
youFpelf Chapter 2i "Hhat's la d Baiuer" and ^l^o Appendix 7, "File 

KaHB^)^ If **LBt Appear? In the CATALOG aa 
BV BABI ACCOUHT 

111 fact has your laltlaCs placed flp tCnCtal charaQtera »t SOdic pointta) in 



the 



nane^ then It's unlikely that nnyoni? etae can acce^p th* fll* 



TUlm chapter Tol-ntlons a variety of waya oE prntecclnB you end your 

dltikettea aR^ln^t vatlDua undeaJrdble aventa- You*!! prcibably find one Lir 

more of tht technique^ ul^Tul at one nlpt i>r ancather- Ffrat, CDnsidfct 
rruiltliift a special parpftfie ^'tumlEey" aystciti* 



CREATHG A lURNKEY SVSTBVI 

Suppose A doctor wants to do the of£[c« aCdOimtlnK dq an ftPPLE II ^ 
Td^aLly, the office fttafi ahDuld ha flble CO Ainply turn on the APPLE 11, 
type 

{BEStT> 6(C:TRL>P <RETUR|g) 

and inunedtJtiily be in the pLcMvt the doctor'^a accQUntidg program,. Sine? 
the flccQuntlng progran would fhopefully) cannnu L cat e With the uaer in 
ordinary English, the staff wouldn't ciecd Co hnow BASIC or anything alsa 
abiiuC the APPLE IJr Thd computer wntjH become an accouatinft ^yvrtm, ita 
internal characCerlat lea un 1 mp or C ant Since all th^ staff needa to know 1» 
how to uae the account I nft ptdgtani 



Thla is Che essence of d "turnkey" ayetettii £rom the user's point o/ View 
the computer ia A device that does only A particular taak^ flfld gCCClng the 
ayaten atarted I& aa aljDple as turning d kfiy in a lock- Xn thla caae, the 
""Itey" Is Simply turning the Apple'$ power switch and presaing five fceys 
on the keyboard. Ic does not require ^i>»poC*^r tinpertiae to be nble lo do 
Chdtp 



Vou catL u&e tha cCljtette'a "greeLinjl prcngrasir" Hanfid whan you IHITlalLzi^d 
the lilflbecce^ to turn yout APPLE 11 into a t^mhty system. LeC'a qay thrtC 
you wanted the Computer to run the CrthHK DEid program fprovli^ed on tho 
Systen Haater diskette) evrry time you bp^ted Dilk tJw Ufirc'a bdVE 

1) tHlTialize a !^Unk dl«kette» aa deacrlbe^ in Chaptftr 2» 

2) place the Syaten Tlaater dlQlcett« In your drive and type 
nCIH COLOR DFTIO 

Once you're satlpflt^d that the progran RUN? correctly, typ* 
<CTRL}C 

CO ^Lop the proftrum aod returd to BASIC- 

1) Put your newly IWlTlalized diskette Into your drive* l^e'll 
4SliuDie that you called your "gteotlng" profiran HELLO when 
you INITlailzed the dl^beCt^- 

fi) The prcigratn COLOR OBID is now iu taeJuory* When you type 
3AVE HELLO 

OOS will eraae your QTigldal Kteeting program naubd 



HELLO and aave the COLOR DEHD progran under the HELLO 
ri!« nane- Th^ COLOR DEMO program ia now the greeting 
pro^rqn un yMJt dlftkette- 

To Eiheck that all worki am expuCLtod, booc ch« dlalc* 

lou abould K«t the aama pTDgxaB that you used in fttep 1>p 



VOu'^ve Just created a turnkey aystem: Whenevet thaC diskette Is tipotedj it 
will automatically LOAD the COLOR DQ40 prograa and R£R4 it» 



LOCK AND imiOCK 

SoBPtimEa you'll want to prevenb a particular program it^m acc^ldNtmlly 
helns erased froii a diakctte! the LOCi: ccumnddd will do this for you- 

E}tauple: 
LOCK KESS, 02 

Th« CATALOG oE th±a diakette'E contents will noV ahov an aACerlsk 1 * > 
Mitt to the entry for WESS- 

If you doclde yon no longer ^idh tb ka«p the file LOCtCed^ the UNLOCK 
comnLsnd will (aurprlEe!) unlock the file» 

Licaaple: 
UHl^CK NESS 

The syntax £ar tht catnDanda ia 

LOCK £ [,Sar [.Ddf [.Vv] 
UHLOCK f [^EsJ IpDdl 

The Interpretation of the notation ia dl^cuaaed in the Syntas aectlon of 
Chapter 3- 

If you try to PELET^ or REHAHE a file chat's LOCXed you'll teteivc the 

mtfiaage 

riLE LOCKED 

You'll alfo »e ttti^ neeisaBC if you try zq &AVE 4 file uflln^ the name of a 
LOCK^d file (If th« File you''» trjlng tci BATE Is in tha umc lanBuag^ ^ 
the LOCKed file)- 

If you try to SAVE a file uaing the ubh of a LOCEed file in a dif faffttlt 
languEtge. then you'll reE^elve the neaaaga 
FILE TUPE HISE4ATCH 

Try ajiAin^ uning « different £11« nuw- 



VHHFY 

(h£:4:aairnii i 1 y [ ci f o mm 1 1 on may not he recorded correctly on a diahoCtf - 
Thla tnay happun if cht! diskf<tte i& Scratched cr dirtyt for example. The 
VOIFT coHniaiui reporta a File vhich [&ay be daDsged or writCen IncorrtCtly- 
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Ttie irntu la the n^i]^] one For DOS ccHiDdAt 

VERIFY f [,Esl M>dl I.VvJ 

Ex^ni|i].f-.-^ the wsy to use th« COtWAftd Eollo^t 

VERIFY FLHAHCE-e,D^,VZ2 

VERIFY checks tc Be« thdt litFiHMUlm In tlH Bpntriftd fll« Is 
aell-^oulflUi^t^ It It iB^ ^ou aa« w ^twiggj ^ cbuKtw fox 

the lu^ng* yoa^n utlng i* *1b^ prlnt^dl 
> for Int«B*r USIC 
] for A^lvdoCt 

cloUmad* If jiHi UVEd pro^nii eME h» Mwnd up ■cwliov* it vlll 
jtlll iM MMd up on Ch« dlilMttfli It vlll mtlU VUtlFr* 

Tf the VERIFY GQHUd ffodtf u ■TTOr* thft 

m&Bftage Is dlsplAJAd- 

if you cry to Tliln ■ f£la that £n'c cm tfa* dlak^ th* MMflit* 
FII^ NOT FOUHD 
Li ptBHDUd^ 

Tau can net VERIFT from lDt*A*r BASIC, Api^UAOftp nr tVie Hpniti^r^ Fron 
these langU^gfe ycu maf VKln aof typ4 t^f flle» incLiiElliig text files (a« 
Ch^pC*rs 6^ 7 and B) nd bhUju laDgiiaBe progroH (see Chapter 9)* 



WRm-PROliCTMQ A D»K 

The l/)CK coQTDand ^llovfl you to pfot^t 4 p^rttculfiT illft* But snetlKi 
jWft irtll vjant to be iur* chdt all fllu On 4 e«Ul£ll dlUketCft «n Mt 
UcUentalLy written over, and thiu L«t> ^iC«-pTatKt*' m dlstHtttt, 

jou. _mvAly wed to cov« 19 tfa* iiqii«r£th *t£»-pEvUct cutdut In thfi tidft 
of tb* dl«k^ atlcli^-^ *dh«Lv* AH vunfllvd for Chls.'im^oH vtw 

rdu pi^luH dj^4Ct« butp in m plDch^ «nj pi*u of BEufdr t«pA «tll do^ 
rtat« tbU tb« SjMtm HiHtn ditk^tt* doai ni>t Unft a vrlta-^protut cutout 1 
^ ft«i»aiwff br writft-prot«ct4di 
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r( v^^ii iN'H iitn- yjiiL vEiiit Co re— Ljse a vrlte—pratected diskette, ittnpLy rtTidvc 
Mn- I .ilhH-l 4^i| 4-.ll I t;d ,i tN.iI t-merti the write-protect cutout . 

Sl^iiii ^>t~^JK r j^riM L .iiiiiL>c bt' uhed vi th a vrit^-protectBd diakettB^ An example 
ol auch H progran Is ANIHALSp ou^ of the demoudtrRttoia prp^Tama of the 
eir«C« MBPtfll aiAim hxt B7«<« HHt« in your drlv«| ud boot DOE if 

7W iM«d tb* Mbtf tjppA 
LOAD MHUALS 

vtklch Hill pat tiktf progm IdEo ihutt^ Row type 

pro 

4nd th* HUfrAge 

Uflt^ PROTECTED 
STfSppFP AT 1040 

LlUpl.iyt^d- ANIHALS won^t RUM on 4 urlte-pffntec ted diskette 
l>4-i .UL-.4- l[ 'r.iv^;^ in f D rna 1 1 on on the diskette each tine you play the ^Dl4- 

v<iii l^UN tite prograiD, the diskette in the drive must not be 

] ptm^ctedp else the Inf ormatloii can't be writu-rt ort the dl^VeCta^ 

Kow AHUULS la in vmory* hut you can't ROW It with the Systen Huter 
dUlc«tt4* Put u iultf AlltH d4.Kd«tt«T o» thut 1« wlC»*^hi4tKt<d» 
In tbi drlvA. ifnt type 

RUN 

and ziow yayi cdn pldy ANIHM^B, a gaae that vlll "Tenember^' what you "tuch*^ 
It hy saving the iii£Draatlon on the dl&kette^ Hieu you'r'e through 
play Ins 3 type 
SAVE ANIMALS 

ic^ ih^l you'll have the game on a diaketto that's HQt wrlte—pratectAdv 

II you type 
CATALOG 

you fihouEd SH Cbftt htm ttot Only 4 tiO]^ of MTDiU^ o& Ebt dl«fc«ct«f 
but dlso d Hv rilfe UlltPd' JJnHUiSnU'tMt in#~ctut«d: by t>i# pmsratt 
AMIHALS* 



noncim TOUMU MAimDuumBt 

Floppy dlskQ jrfr BEoCdy Ad roll^ble oompdred to aome other uays Qf 
storlnj^ computer prognu for example^ on the backe of old envelopOQ- 
Eut if's ^tlLl pOSfllhlfi to loae or destroy all Infornatlon on a dlakette^ 
A diisVptte [aay j^et aoratched or damaged by heat; it may get loat, or a dog 
in.i^ 4-1ifLg Lt p boa^ona say decide to use it ^a a f^labee 4t the beach; if a 
dlttkiscte isu^t Hrlte~prot«ct«dt It uy iccidcntAlly git wrlttin ovar* And 
m dl^tt4 vlLl Bvntully «u nt -» a lU«tlH o£ U votUng bout* £ft 
libimt 4nTdi«* 

ItorAl H 

Kfltp won c1i*ii OM copy of 0. ^ot»« Uound If you ddn'c want to lofl« It- 
V I ^ ca^t«H4^ "b«k t9*^ uy vAlti^l* progm. 

JlJ^^^J If yo^ ST^ in the nidat of wrlr^n^r fir m^idSfytng d profitdB* ont way CO bact 

I up tht prOKtBB ia to keep L-npU■^ nT j.-ririiL'r veralona- Then if the current 

t - ViffHlon i^ l™t you CM fdil bdck to th^^ n^KE-mDSt-recent v^raioii, and 

|pX-^ lHip«E4]]y mt iomm too mxA pn^MMJnf tlw* Ou ny to do Gi±m is 
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Ecl end eAch f Jit Qflnp vich d nuriicT vhicli chiflBsm trdm v*relon tc) v^rHton- 
For EKdnplep suppp^e y^U OtATt to vrlce a prograio E!dl[td PTtUHC^- The 
first tifnr ycu flffvt cliD proHraDL^ cull It FINAUCE-1 ■ Next time yoy worV an 
the pro^tratti^ IMVtr it Unc^^r the noine FINAI^CE-?; chc third time, it becmen 
f]NA}l£]r^- "ij Atld flP on- You'll wind up with * vhulr CCllCcticm of FItUJICE 
prciBrainB^ with the lurijeal; vervt^n niimher representing the noat recitnt 
Liersfon the prugTatn- 

It'e a £OQd ld^4 to SAVK a dt^V^l^^lng prDgraiD periodically [vi A ndW 

vcral^n iluiiibet)^ If 700 thiB evtry ]5 or ?fl mlnuteap an untxp«Ct«d 
power fAllure or other dindSt^r Will not erase all ycniT work- T» dAn, of 
CUurbe. iTTinedla tely continue worlclrtft after SAUtlnE the current atflte of th? 

prftKr^n juat be aure to esal^ 4 nev vflTPldd irunber for the ne^t SAVE* 

If the dlfikbttt starts filLion up» nELPnTr floTne of the earEler versions^ 
Bur It's B Good idea to keep fiCVi^rdl vereions Around^ Irt tafto somtbinB 

calapJtaul h;kpp«nfi to the current TCrslDnp fir you My JuGt happen to want 
an earlier version — not all reirlalonft are 1 nqn r ovenen ta » 

The phrnae ^Ijacfclne up" le alao |ia«4 tfl deacrlbe keeping iruUlplc copiee of 
prograu Pn «t-pdrace diahettea. There art tWn approachea tC4 batklng up In 
thla faehion. The flrar K?rhddp nalng one dlak drtve^ la ta alCnply E^AVE 

C>l*: ptOEraro on nne diskette^ remove that dlahectc ffon the drive, Iciaert 
another diskette and SAVF. the praxes a^^lrt- 

Thc Htttind approach Invnlvea duplicatlnE all the Infomatlon fron one 

dlahette onto a aecnnd dLa)c«tCe^ OfrldilA of the aecund qpprciacJl nr* 
dlacuased in th*^ n^KC tiection* 

USING THE COPY PftOGDAM 

\ou can uae the C^fV pro^taDr on the Syetem M^^Cer dlolcett«» to C4py tht 
entire contents of yaiFT <;hjrrcnt programming diskette i^ntQ yo\MT bAt^Lt-up 

diskette- TF you ivre uelne DOS ftorn Applesoft BhbIc, COPYA tbc proftaa 

to uae for copyln^r a diplwtEC- 

In these copying proKr^Etf^ Cht diskette from vhlch copyl^if done Is 

caTled the "oriRlnal" dl^hettr^ The entltc cnntenta of the QrLglnal 
diakette vill he Cdp^cd Anto a ^duplieate" dlpltette- The duplicate 

diskette dnea r^at hjive to he iTflTldllzed before being copied frnto* In 

fecti «ny prevlOuJ Inforaatlon that waa on the duplloAte dlakette will ht 

erdud» 

B^r^irc copying the original di&kettep It'a a i^ood Idea to nite-prrt^cC 
It* Then you csn't accld^'ltul ly tra^e Ita cantent»» «v«t1 it you put It 
Into the vron^ drivo- 

Aa deffii^lr VahieSr the progrsn InltlaMy iQSj^urHe that the ofIbIf^] dJslwtCc^ 
uElT be placed in the Currently aelected drive <th^ drlvt frum d^hlch you 
ran f]OFY or COPTA) carme^ttrd CO the controller card ifl the curr^nrly 
selected nlot* The duplicate diskette Ifl D^PuTmd tn be In the other drive 
L^onnecteJ to the SdK controJ-ler card (even If there isn't encjther drive 

there}. To uJt eny of theae default fllot or dri^o nutrisera^ Just preao the 
RETURN hey utien th^ drtdult nuirfter la ?hovn« If dny of the default nurt|li<^r^ 
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□ re wrnf^p cither f^T the original or £or the duplicate dlaLtctte. you niist 
type the correct nuTd?er vhen ynu aee that default mivnbf'r Ott th^ screen* 
Here's ^n eunpEe of usics the COFT prograTn on an ApE^lc with one dLflh 
drive* It nssuws your disk drive la attacihed tu e dlat controller 
cerd Ip the aapie alnt as the nne frna vhlch you rap CDFYi 

1) Place the- System roaster dlakette In the currently selected drive* 
Type 

Klffl COPY 

{WJS COFYA frmn Applesoft) «ad AEter the UQU^I vhlrriug juu ahould aee 
APPLE Dl^^lfc DUPLICRTICW PPOQ™ 



Z> To use the proK^Av'^e default slot nupber, alut f6 !□ tbla eEanple, 
Juft preaa the SEIURN k^^ 

3) WhcFi the ntepaflge 

nppeAra» preas KEIUBBp 

4) Frt^s RETTJHI-] agflln vhU yDa SM 



3} E^eu you see th* ilfifjtulc drive oiiAib^r For th« duplicace diak«ttet 

type i* 

6) Th* DftSHB' 

wljl appeatp "This Is yOut elgr^Al m renove the Systeni Haater diaketCe 
EroB the drive and icuert the nrlginil dlakette, frnm whLth you wish 
to copy. (Did ycpu reaiBber tu write-protect ymr cprl^lnAl?) 

7) How the proHr^n vlll prnceedp flttt by dlrectlnfl you to insert your 
orlgIrA] diskette, then by InformlnR ynti thet it ia reading InEorrMtioa 

frrni Che oriRlnal dlakette* Then the prt^nr^m wlLl let you know vhen It 

is resdy for ynu ts replace the orJglnel diftketCe with the dupllcete 

difiicf'tte In the driifer and «hen It la fonnAttlng (IHlTlflliB lns) that 

dlakette^ After the dupllCACe diskette i& IHTTlatlB*^ you will be 

instructed to re-insert the orlaln^l dlakette so that the program csn 
rt;4ld eope sore infomation frun it, and then to re-if^ert the dupllcste 



diskette M thAt Clkf £nf ortndtlcpii can be copl^ auto tc- These two dtcpB 
will have tt> bt reptaEed until the entln orlalnal ha£ been copl^d^ 

) Vhen cutyjn^ |a cpuplfrte you"!! eee the hssoh^ 

Tf type V (yeil^ the Cdpylof prDcedure win b* MpMtedp aEsuHliifi 

tKe Bimt lD[iatLDi](a> for t,h^ ^rl^lnel and duplicate dlak^ttesj Be ^^L^rt 

you Bee 

^ "RETIWI^ KEV TD KQIN OJFV — 

and that ymi another diskette (either a hlflnfc nr one with imvantEd 

I ftf ornifltiDD oci it) pa the dupJicare- II don-t wish to make pnoCheT 

^Jpe Tou wElI J«4ve Che [^rogrdin a^d DOS vlIJ asBuu yotir 

default df^k drive to be rhe one vhich vhe the iDcatiqn pf the duplicatt 
diskette* 



If ycu brtVe Bore than one dr^ve^ ffpeclij che Blot end drIvE luinbers for 
the ariRlndl duplicate diakettes ond Irwert the diftkcECefi in theae 

IncBtions ht£ore the copying uegina. Note: If you have mre thsd OM dlft>S 
drive, the eyi^iem ucPn'E prnnpt ydu to teiiDTC and replace dlakett«* Lt 
only doea that Eor single drive copylns^ 




IF you Cty tn copy Onti^ e i4 rl t e-p ro t cct ed diskette you'll see the ne^sfl|^ 
I/O ERPOE 

STDPFFTi AT [you'll SCe a line nunibet here) 

Until the vrLte-protect label ia removed froa th« duplicate dlflketLfr no 

Inf oriDB tiofl c^n bt pot onto the diskette. 

Ati I/O ERKOtt Or UNABLE TO RTjU) meEaae^ vlll alaci pppejsr uhen th« drive 
dcic*r l4 Open or If there Ifi no dJafc^ttt Irt the driVu. The&e DEaaagea may 
also indicate b problen uith the diakettp In the drlv«- Re avnr« that the 
der^uLt drive nuTTier may have been chaORed flTttr you have ^tt^n Ort* Cif 
these meaa^gea- Wheu }>ou r^Un the cc^y program aKBln, you nay have to 
apeclly the drive locration of the System Heater dlfihftCta' 
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MORE "HOUSEKEEPING" 
INFORMATION 



1^= 
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4i niina The Hum Bpaas tt^om 






DEBUGGING: MON AND NOMON 

The pracufl oF trflne to get * pTOfirMI tP run the way ycu want It M In 
called "debugglnEs" proRraii i^rrcirj ere often Teferrfld to as Tjubb"* Ail 
diBb rcilTVT^ndfi and all Infannfttloxt tfent between the CCnputer and the dfek 
are norTnol])" not displayed csn tli* »cr#eQ* But when you're debugKing, 
mOnltdrlng this Infanutloil dan help yoM treclc d«ni ptDbleBa. 

The HOU cDHenn^ Allnn jmi to HDNltor a varlecy of Infcrnatlon' To turn 
various pdria ol the di^plty tEi agsirp ub* the KOHOia tifo m^lltcir) cwnMnd. 

Three dlEE^rut pdrameterB that amy be ua£d Id these cotHunda ; 
C atflnda for CocDivfida Co th« diAh Uui:h aa a?Eh, PUDp etc} 
1 atanda far Input fcm the disk (when SC^Dldg A flle^ 
pcnnda for Cutput to the dl^k (wh*n WHlTZlng h file). 

Thcde ^Tametera era u^ed only Witbi the I40HQF] and FDN {zoranunda^ UflUlly 
rfOW^ CW,0 la in effect: no ncnitorErt^ i4 Eahing plaize. 

The aynt^K for cht fzcrnmanda la 

HON [CI 1,11 fpOT 
KOHDH [CJ [,LJ 1,0] 

At leaat an^ of the tbftie paramaterB must bo prtamiC Vlth the NCmW anil WON 
cflmmindtip elae the cnminand wllL be Ignored- The parBmeters my appear in 
any nrdar aqd» aa utaual^ mUBt btt aepaTated by coKaa^ 

th^rt dre 7 different way* In vhlch th« HON ccvund uy be UB*di 



conTund 


what It mnltc^rs 


KQIJ C 


CAnaanda to the dt^k 


HON ] 


Input frQBi the dlBlc 


HON C9 


thitput to the dlalt 


E4DN IpD 


Input EroiD and flutput to the dlaV 


HOn C.t 


CoqBandq tP And Inptit Eron tha diah 


HOK C^Q 


Cjmianda to ^nd OutpiiL to the dlak 


HDff C.I.O 


CaiiiTTi4nd» LQ, Input Etom, and Output to tb« disk 



*** NOTE "* 
A HDH cmmand renulna In effect until a 
HPHOK* IBT^ or PP tflrrrrwara only) coinBflrid 1^ encountered 

ar 

until you boot the ayaten 
or 

do a teatart 43D0G)>- 
or 

fleer 

K neat trick: you can iQVtJa a HON commaad and later cancel ft without 
affecting the acreeu format ~ iFVcn the does not show on the acreen. 

Suppose you txecutr a nOT4 comnand^ 04y 
HON C, 

To canciel the cannqnd vEthoot having it print {id the acreau^ iqclude 
PllTHT ^TtcH&N C^I.O"; VTAB FEan?J: CALL -S6B 

habere D?. as usual. cootalH (TIU^Dt 
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MAXFIUS 



Dos alina up to lb flies to dcCLV^ (In uae] at on^? tine- DOS daala with 
BBveral types of flita In addition to thf BASIC proftraa flj^fl dlacu^fied so 

tmr^ Sec Ch^ptf^r 6 for a dJacuSfllon of SEquential tfttt files. Chapter S fot 
rV>d«l-j|Ct^4rt mt Eilaa, and Chapter 9 for the D05 conadd? uied with 
biUE7 [DBchlaa l^|i}tu4£«} filos- 

The HAJininS tODtond frpfccilflea how MTiy flCtCvt filtfi are permitted- When 
you boot i^OSf the Cdnmand 
HAXrtLES 3 

la executed. Whltb acta up the default COOdltfOdC a ujcIbudl gE 3 fllaa nay 
be actlw ftLnuItaneouHly until another MAJtFIUlE cOEmdnd la executed' 

The c^mnand^s syntax is 
H AISLES n 

whi?re n DiuBt be an Integer Er™ I CU 16- Specifying a iralue nutalde thlB 
rnnjce will cauAe a STHTAI ERROR ne^aagf fron either Applenoft or Integer 
BASIC; frotti the Monitor, a beep [a the only indication that you've d^Sne 
BDiHthJfL^ vrocig* 

For each file Bp«cLEI«d ^ >1jOlF'J.LES aeta aside bytCft of luiury appce uJled 

a file buffer. Thia additional meBory apac« for MCh active file 1h u#«d to 

help adjuat Eor the fact that meTiwry Speed la Ear foater tlian disk access 

apeedr *1ch Involvti imchanlQal notion — che dlak head hflg ttr dearch the 

di^k^tte- So In the nane of tfflclencyj a file buffer ia uaed to ^tuff^r" 
Infotvation going to 4nd from a diskette^ 

If you retrieve information from b dtaV^ttep DnS brliifia {n 256 characitera at 
a tine and pMtS then in the "Input" part of the file b^Jfer, then rfelivera to 
you whatever auba«t ot those ZSfr cbaratterft your pro^ran rAqu^stod. If yau 
ftre sending Infannatloo to a diakcCte, character^ are Stoted In the "output" 
part oE the flLe buffbr until ?5* characters haV* accumlatedj then they''r* 
ahlpped to the diskette all at once. 

Suppose you have E4A^FTLK£ I and one file 1b active. An FTtttrnpL to porform a 
DOS CQiAand (buch dfi CATALCC] will cettr^ti cho TDcSSage 
Nf? BUFFERS AVAILABLE 
to be di splay «dT 

Vben thr aydten la booted^ the miidtar of active ffj^s (a) d^foulta to 3* » 
I7»5 bytea of ffltfjwry ate reserved far 3 file buffers. IJndtr aCat 
clrcunatancea, ya^t won't need cere than 3 e^tlve files. If ure fllM dre 
re^ul red p type 
E^KFILfS n 

fwlii-r* n is the nunfl^er of aaeded fiiea) In InCHdlate axeciuttan Kde before 
loBcfln^ and rvnnlng a progrHIk 

Tn imiHdiate e^etutlon mdep chanRlnR HAKHL]^ eraaea Integer HABIC 
proRrana and Inoreaftlng HflXFTLES neaaea up Applesoft StrfngSp afrce HTHDll 

Jn mved dewn wCihcut rftVlng the pragran or atrlngfi- To irvald prcihlen, 
rfaet FiAXFILKiS before loading and running a pro^raA* 
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If Ifi usHi within proflracij It changEB creaory pOinterd. dnd d 

GOTO, G<3SUB» OT other 1 t rue 1 1 en cdn £ct EoAt- IE you nuEt changt! 
MAVPItJ'S frciiri vlthln uri AppLeaoft progranfip nah^ the HAVFILEE camun<] tht 

first QtatemeTit In the progran^ beforE Diiy string Vsflablfs arc dc^Eartfd- 

To uae KAXFILF'^ frcrn vlthin an Integer BASIC prograDp you n4ed CO CTtdte Jin 
EXEC ILIf^ bs di»cui^scd dt the pnd c^F Chdpt^r 



TRACE 

Thr Appl^floEH TRACK cianiuDd lH a uicful d«hug£ii^ tocl« But vhea TRACE is in 
effect. DOS tOnnands Ir^ld^ Appl^Boft programE rTon't tfork b^cauiir TElACi: 
prlF>tB the line number befflre the DOB cOTmnflod- Thtre^B 1 pflTtlfll aclutlon 
to the proBlem* Ton can Infictt d RFTURS (that ±0^ CHR9fl3}J In Che \>$ 

and then PC9t DOE comnianHifl iri.lL vo rV ptopcrfv tven if TRACE la In eEftCt — 
aee the excf^tlon bclQV* 



Tf TRACE la In effect and "OS trlefl to RFAD an TWPUT from the diskette, ytnir 
prc^gT^n Vl]l Inatead Btop and Ualt for iFlPlfT frcn th« ktyhcur^* uhlch Ilmllra 
che uaefulnesE of TRACE In connection vlth DOS« 



USING THE MASTER CREATE PROGRAM 

dtacuaaed In Chapter 2, INIT la uaad to cTOilte dlavd diakattes- Tc thiB 

3CCtJoF> you'll learn hen/ td credtn nd^ttt dl^kettes^ Th^ dlatlnctlar 

between a slavE ^nd d tf^at^T la ci€\t re^dl ly apparent : hoth dome charmi ngly 

Ittlred In the lateat In bLatk plriatlt (no» not L^atlier) Rarh- It'^a up to 
you tc revlae yOur gteotlfi^ pro^r^ ^nd ^iakette label to remind youfAcH 

vhioh id ftlavt dnc^ vhlch JT^i^ter- 

The SyateiD fTaAtfrr dl^hette cont^loa a program called HASTEK CRI^TE that can 
run on an Apple II with at teddt 16K BCnWTy. The HASTER CPIHATK pro^rdti 
doca the ftillovlnH for you: 

* Corr^artfi a slave dLshettt (wtlMe DOS la me no ry-a 1 z e dependent 

Into a nadter di«k4tCC (vhoafl T>nS la self -relocating bo that 
EneBory is uflfld efCJcimtly on any alee ayatem)* 

^ OlvcJt thft conv«rt«d dlakette a new greetinR progrdfl fttwe^ the naw 
]>a5 wtll attenpt to HV« fdch tlrrw the diskette id boorcd- 

The HASTtR CRF^TB proQran Duat be uaed With a dlnhette that haa already 
been If! JTldli£^c^- It will not work with a dl^k^tcc thflt 1b write- 
pro tccted ^ 
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Hero"! in tUBplt of hmr to upgrBdd the Jlvktett^ [HTTl4ltved In Chapter 1 

ftbt MP with the ONE TO T£N prcgrdh on It) ta cofivert the slave dfakett^ 
created by I N LT lnE4 a U^tCT dlakette* Eot convenlmcei that diakette 

Will b« r«[trrei| tn aa dlftVeCCD OhR In the dlecuaaioii tbaC follow^- 
BgfCTfc lUlng HASTED CREATE, do the folIqwtnB: 

\) Insert Chfc [JlB^Ptte you wiah to convert — dialtette OHE for this 
eKsnpl^ - - Into the disk drlV4r. And BUN the diskette^d £TefrEiftB 
pr'iBr*" ~ nawd HELLO on dlalcvttc OHC> The meaaa^e dldplaycd bj 
d j^reetlnit program should Include the vera Ion of TWS uSOd to 
]nltl4li^e the dlslcettep dnd ItB StAtU4 aa slave or maaterF 

2) Cl^an^e the appropriatd IlntB the Rreetlng program to dlflpldj the 
neu iFtf ormatiOhp "HA5TEB DISKETTE"* Then SAVE thlft n«W Verllon oE 
th* greeting pcogran^ If tho dlflfcette'ft outalde label requitud A 
Blnllar ch«PBe» laake that change nov^ 

Note th« nud the greeting pro^ram^ It you vimh the converted 
dilhkttte to ^US this same pro^raa eacib time It 19 boc^t^di ]Wt It 
did before convertings you will gi™ tbla greeclnn program ndne tc the 
tfASTRP CREATF prograa^ later on* If ym'vt alwaya wished your 
greeting prngtBa hdd SOtt* Other naee than Ita preaent one, KEINA^ 
the greeting program now* Ldt^r, Jaa will glv^ the n« name to the 
HASTER CREATE program^ 

Tn uae HAST£R CREATE, do the following; 

4) PuE the System Heater dlakette In the drfv«k boot DOB, and 
frOH either BASIC type 

URUH HA5TEA CK^J^^~ 

5) You ahould fltttt the H#aag« 

i.u^ _ in^ ? til-CWEflTE UTILITV 

6i Tou'^11 then be told to type the areetln^ program name 
to be u4dd by the dOiiv«rt*d dlskettei 

r-^£q^F IWPSJ^ The QH^Tl^iG PBOQfWH-^S 
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Wt^Il asatllK that wKfti you SAVEd the revised ftr«Clflg prDHrmn on dlBlurCtG 
DHR fstep 3, above J yov i^^cd the none BCLQ^ Sci CVpe 

unJoEfl you vHh the diaketCe to RUN ^mvK other ptoEtan nau each tlJMi the 

dfBhL^Cte tfl btKited, When you press the RSTUfiN Ibt Co enter the grettine 
pro^raiD Que, yoti^ll 8^e this Ksaaee; 



r»« i»'D-TiMa pwx»nn> off PLfij::^ tt in 

THE i>J:^ Hlt£CTffl7V 

i; FJLE HUME TMfiT hlLL BE 

PLm^l^ UlTWIW THE" inftQfc 
HCLiO 

PVfCT TME OiS^TTE TO BE WKTe^ IN 
P£>re ?F VOU URMT ft DlFFEIfENT FiLE rrfWt- 



7) ¥d]1dw the taetructlona- Benve the Syscen HdfltEr diskette from the 
disk drlvr and r^placa it Vlth the diskette ycm vlsh ta convert — 
diskette OtiH id this case* Finally, preaa th« RRTVRN bey Cci be^Ln 
COnv^rtiilE; the prograa vlll tnfera you the prnceaa Is cenplete. 

AFter UJ Ing the MASTER CREjITI: program^ aJvay^ rC:-bCKht VOS before 
doing any other Work. 



*** Note *** 

The greetiofi progran fiefflt that /«i give to the MASTER CREATE pirpgraii Ifi not 
placed In the diekette^e CflTAUfi* It juflt telLa tlie dipkettc's 005 vhieh 
progrdn ndine to RUN each tlK the cU»lc*CCe is booted* You nu^t ineke QUro 
that the diskette's CATALOG Actually COntdliU e ptogrsH hearing the vaiK 
tIflIK you rIv* to th£ HALTER CREATE pro^qn- 

If you forget tc do SO (by shLppiuE etep 3 sbcTjelp you'll! see the De^e^Be 
?1LE HOT FOUHD 

esoh tlK yc^u boQl the disk UGln^ this diskette* 



*" Reminder 

Tou nst refliep^er the n^TTre of th# greeting progr4n for each dlskatte- 
Vslns the BOfne areetr>^^ program nanK or oil of your cfi^kette? W^eq this 
E osier* 




SB onV^ and GLOSBlfia Ii^uHtlAl rtlaa 
bi lytA-^ftt Off Ibn 





^Tftyai ^^C^-W^iiv>^.^l ^ J ^- I- r r 




TEXT FlUSi AN MTRODUCTKM 

S4wtlnHB you'^n want t* UH tin dltk *toM inf ontftlon th^t iB not a 
prnRT^n- VcHi uy» for 4XmApl«p villi C4- keep ^Oplu of Hrr^apondeDce, a 
llAt VQTd4 uned In A WDTd'^giMHLnB IntsmdUta nsults a 

r^lrulAtlcn* or a mAlllng Itet* «. K« ftU^ ■OfHTUUB ull«d V d*tp 
f 114? wll I fllloi* you to do thifl and mre* The lattn T Hrkd tMt fllu 
In tht^ CiMALflf. nlirt^H^tary* 

I i-ke f 1 1tR ^re creatE^d ratTieved ufliilft DOS command* In n IllC«i«t 

KASSL. Lit- AppUsofc proarflm- A t6*t flla b& i;tB*t*d ulni ■ ptdgru 

It 1 1 " ill one Laneuapt iind wttlCTftd f«M * dlstrttft UAlUft A progfOn 
written in another IdiiguaK*- 

Hoflt ift^U piVtCmm l4 (tie oidnuAl- are in AppLcSCnEt- If you Wish U 
Ma«rt th* progrM* to Inteser BASlCp recall that in Integer WSIC yott 
cu^t Mike «tvli« dmTA ud r4u ikipt DDftuloa aCrlug nrl*bl«Q^ Id u 

iDtegvf PASIC covand « 
inpirr ES 

only BBHIRNe dwt OTmrti*) mj Hpante the Eb»* nvpnwH* Tblp uznul 
doea dot tell you how to uke 6Ach progrU run In lixt«^r BASICt «U th« 

Appendi7[ H of chf Ar-r-legpft ll basic P^ "KTrriti.Tm ^T**^"* WlTr.TTil f« 
details of CDnvn-rc [rift between languas^^- FC^P (OB* hinti dblKlt Chuglog 
the BASIC In which a proaram runa, aEter tha proinft hM be*n vrlttett* 
■« page of cblA DOS ■nual* 



Vbfi O0& coun^nds LOAD and KDH (alio VLOU 4rtid BBmi} may not b« tued vith * 
tnt file- An attempt » d& n vU.1 C4tiH tb* ■eMs(« 
riLI TYPE HLSHATCU 

to ARtur* LOAH mi tsm up«t m DfkBlC T'^K^'* <<^ 

«p«t a VlHr; auhln*-laiipii8« fll*I» not a cnC flUi Instead, you 

V«t vrlta pnarav tlmt 9ud data to a ttM- flla and rittieve data fm 4 

C«xC rila* ualDg tlw iWG-MBBauda dl«ca4a«d In thla chAptan 

OPEH 

CLOSE 

RKAD 

WRITE 

APFEHD 

POSITION 

EXEC 

Tba CQMiadp D?EM, tEffi* mm» A^PEMD and FOSITIOH cannot be used in 
iMirTfirr rrr— ndc*: If yon try to (lo ao, you'll racaive the waaaga 
NOT PIBKCT COMCUD 

Tha«« c0^uttda nat In q«4d In datarnd-aicacatloD that la» Froa 

wltUn d pMgraH* Th* eoMianda OflWt «m1 p^y b* uacd 1* 

ljiii44l«t«-«atacutlon vde- 

[n .iclclltlon t4 the Aoaaanda Ltfltad alwra. th« UK H»aiid4 
LOCK and miLOCK 

DELETE 
UMAUB 

HOfl ami BOHm 

mipt 

CATALOG 

wmW vltb t«t Cllea la lha aav way tlwy vlth praftraa ClUe* 



4B 



ttrtt* aro tm dlfearanl typ** ot tmt lUaai aaquantlal tavt fllea a^d 
fandQ*-acc«a EHt-FlIea^ Both tjpea of text rilae atore ntriasa of A^cn 
C0d«a C4 rtpraHnt tha 44ta, bat ln different foraata* DlagtaiBa of the 

typaiar* ahon bilcw (the character reprastCLts tha 
inum tihatactart aaat aiptiMKli:aJ.ly fl| the ad of wwt FKINI acataiiaiitaj* 



"PICTOKB'^ or A 5BQ0EVTXAL TEIT tns 





A 


T 1/ |0 ir^ IE > IB IL ID |W li 1 1 


1 


1 


1 


1 1 


IS mmEa EE EDEQESEB^ EQ ED □iiBLu ruru rjj rrj^ 



ABGIl: 

Vilm BytAi (112 2*36 7 6 g !■ 11 12 1 3 1* 15 16 IT IB IB 2« 
F1«W: » t 2 r 



"Ficnme" of a uvddk-mxiss ieit file 





J 


r 


1 


1 


>l 1 


TJ 




1 
































ASCII :| 




I13IWI00 




\ai, 




l», 


179178 




l«l 


l"l 


|76|79|87|13 jW] 




# 


12 3 


4 5 


6 


7 8 


9 If li 


12 12 


14 


IS 


16 17 


ia 19 M 




The t&rH "field" end "record" vdll be dlscuaped la Chaptera 6> 7 end 
The {zomaanda OPBH» CLOSt, Mttm «4d POSITION an wad vltb both 

types of fllaap but lA toHMnat vaya« Saquantlal taac fllM an 

aiapler to ua and vodanund. ill acw napactap ao M vlll dlacua tha 
4d« and atructuta of HqaantUl EtxC Ella* firat* Th* uaa ot 
raiidoiiKae«4a4 t«n fllea la daacrlbad In Chaptar Ibn doCallad and 
tacbnlcal l^onutlon about all tjpaa of filaa cu ba Cotmd in jlfpCAdlx C> 



SHUHIULIEXr nut: MM DCAMPISS 

Suppoaa you VUC to naka a flla coutdinlnf a Hat a£ vorde te be used In a 
inrd*tiiaaaln« gaw. tera ara tw palra of praEr^Ha that de^l vltb euch a 
fila. The fttat ptostu in Mch pair csnat«« 4 tut file on the dlaKette* 

Th* aocotid pfoBras In aacli pair ntf:l«v«a th« data atotad In cha taact 
ril* r»« the dlahatta* 

Thla progTatt i^reate* a taxt flla na^d vdbdsE, ccmlalnilitt the Uotda AFFLE* 
BAHMA^ CATALOO, DOHHUrT^ EAGLt* FRUITp CDOSE^ HAt and ICICLE* 
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5e PfflHT l>». -OPEN WIKD^'' 
^ PWIHT -BflMHWR" 

W PHIKT "Pnoti" 

im PRINT "FfWJT" 
lie PBIWT •^OOCSC"^ 
l^e PBIHT *MnT* 

Line i9 OFEKa the IHt, ualne Tiornal fariut (or &endljiB a lx>5 tomtnd 
frniD wltfilD a BASIC prOBT#>- OPEli places e MXt EHe nained WORD^l En t^e 
CATJLLOG (If It not thete prevli^uBly ) « 

LFne AO^B VRITR tcmndnd c^ua^a ^ubaequent dut^^ut fron PRIKT stateneTitb la 
be sGTtt IP the named test flLt Instv^d of to the TV tcreer- So £□ tKla 
pr^KiTElnp tfli^h PRIWT Btateiuent in line* 5(1 through 130 will sapid the irord 
Iftftlde the quotatlrm ifuxr>L5 tc the text fild UORDBl^ and not to th* TV 
EC rccTl ^ 

Line 1^9 CLoSEb the fllej and end* chr Jlle-VTltinB pTcczesBp 

If the program lE BUM mi you^ce not in HOSitor node you iron^t dtt 
ditythlng: LiauaCly E^E cfinn^nda and diak input dild output are nnt 
diaplny^d- But iEp as explained in Chapter ^. ^VPC 

for slvnply 

aince do Input fTon the diah id involvtdl and then you RVS the above 
pri^ftrsH you^ll flte the fnlLovlTiE± 

itPEPJ L^u^_ _ : 
DOBPWiT 

ooose 



At this puint yo^t'll hAVc a file called VOKDSl on your dlAkctte. UDEID^I 
ulll niqrfced Vlth rt 'T"" In the CATALOG to Ifidlcat^ thac It^fl a tcXC 
file- Thr ftLc ccmafHta itema of datA fin this casep wdrda) aeparated 
hy KlrrUPTlB^ A RETUnT4 i?h«TBCtfr Iff autondClcally aent at the end of every 
TilTHT flti^teBent uhtcih 4Qea n^t end vlth A conna or a seHLcDlon. Hote that 
in thta aena4^ each HETiniN Is a character rather than an action — In 
pprtlcLilnr» Lt 1b the thar^ctet with ASCII cede L2. 

Bfl^h il^m 5f ddtd. ending irith Ita fimnfl characteT^ !• ullad a fidlri . 
A ti^id id stored in the text file M a aariaa of chdtdCterd repreaented 
hy their ^Cll codea- The last chara^Cttr In Uch field nuat be the RETUILfl 
Eiharacter, ASCXI code 

lb called a Bequentlal teat file faecfluae *ath field is stored 
be^lnninE imiDediately after the RETUHW character of the preceding tield. 
Uheci etDTed Oty the dlakctte. fields nay be of different lengtha: the uard 
APPLE takea h hytes (one for each letter plus Ont (or the BETURH 
character)^ HAHAHA takea 7 hytes^ and so on- A Bequtntial tewt file la 
BEored on the diBkette aa on« L^n^r contlnuoua aeriea of ASCII-coded 
rbnraccerar a chain of fielda vith no gaps left betwaep them. 

□nee VORDSi ia on the dlakettt« tha quaatloa Iiuadlately arisUp ^aw cm 
I retrieve It?" The to-lldvlns Appleaoti prosTan vlll retrieve WCRt>S^± 

1& ROT RtT^rEVt WT-T^rJ- 
39 rVlHT ^0P£N MORPSl." 

» FOB I - 1 TO 3 
^ P«JtI J 

Line 311 OPZrifl thd file; line 4U tells DOS chat all aubtequent THPUT or GET 
fetartiWntfl will refer ta the nameij dipkecce file instead of the Apple'e 
keyboard. Ir is a» If iht disk ^ere typing responaeB^ inate^d of you- An 
IHPLT connwnii aluaya cauStS ane conplete field s ending with Its BETURN 
characterp to he '^typed in" to the AppicF If another JHPUT conmand 
followBp will Cau&C the neat field to he reed irif and go ^n- 5o 
linea -Sfl through 7B cauae DOS to atart At the b«B i'E^i^ ^ e^S of UffllPSl and 
retrieire 9 fielda which are placed in the array AEtl), AS{2)r AS(3)p 
AS(4h A9t?r. Line B0 politely CLOSER th« file. 

If HON Cp r, Is Ml in aEfetC wfaen the above program ia aUN, yqu vlll 
pee nochiag dn your aoreen* But If MOTi C, Ip C {or Juat HCB C» I) U. In 
effect^ you'll ^ee 

C«>€K Vn^l 
7«PPLC 



A quCBtlcn urV ( 7 t is dl«p]4}red beEore each INFETT fron tbE diali, ^iist 
hb it la before each nariiiBl ke^baacd LKfUTr 

Tn Elieck that all uarked as clalmEd, try typing 
FftlTTT A$<21. ASf9>. A&t^) 

Itnd XQU »lmuld BEB tbe waids BATfANA — tzam A$[9> — ibEd ICICLB ind 
Elnally DDHHAHT. ThiB 1b b gaud way chcCh thdl Ln f annqtlon fas read 
corrtctly- 

X 

Tf fau ondlfy the pT^Rr^n HAKE VDflDSr tD make dlfferfrrlt V[>r(l&i be butb Ed 
DELETE VQRDSt befcn re-RUNTiing MAKZ tfOIlDBi. Ef you dtrn^t, yiHi KAy «tld Up 
with a Alxtute of tha aid wordtt dad th« n«V^ 

Here's how CD create a sequential file called HDRDSZ CDntBinfag chc AAIK 
vDtda ad NOBPSr, bui «lLh all nine wDris Jp one field- Each wotd Ija 
falLcuGd by a comffld, ao thdC INPUT statement irith muLtlple varldblea 
(9^ ifi this caael can be UBcd td teCfiova th* Bfipdrdttt wcrdfl- 

^© M ^ REM CTffL-P 

?e HINT ''OFCN HJBi:^'' 

se nnp*T ^ close 
M rNi> 

Note ttiat the PRINT ccuiBHTid In Line ^0 ends with a BeHi-cclDii» A 
Beni-CDlDO Bt the End of b FRiKt cOPnnBcid btOpS the auCC^tliT pTlntlPB ^ 
RETURA character after the iHBt data characterp Tliercf^tC chtf character? 
aenC to the dlBb by the nejit FBIHT CDonftHnd will appear in the Eaag 

fi*Ld with the chAr9<:ter& sent line 5U'b PRIHT ccmimand . The FRlflT 
ccpnund In line 68 alcm end* vlth a BeBl-cDlon^ ed the field stiii douB 
□Dt Hava ltd edd-brkldft BETIFRN chartctcr- Line FAINT cDiraoand ends 

tflthDut d fleffil^colcm or rovia. aUdwIpa the autDmBtic final RETUHK 
charBcter tD be Bent dt l^^tw Thlfi Cnda the £Ield> which nav cDntainA dll 
the chardctdra PB^NTed by Itnea b9 and 70* 
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X 

C!iiinmBK In □ dlBh-ieBB PRINT conand uauallp send chdTdCtern 10 defined 
tnb'fielda on the screen. HDveveri cDnraas dn po^ ^erve this fl^ine 
fri^rnutt \ lUA Tunc t Ion in fUTKT coTnundB u^dd whan WRlTEing tc the dftikc 
th±>4e rchHnn nr^ treated if th«y v^re BOBl-ddltmCF In FHlHTiTig tD the 
dlt^k, ILch* dcparatCrd by cdhntnaA will be CDncatenated , with no Intervening 
ap4icoa LndBttodi A CDmna at the end dE a PRINT cemaand has the aaine 
ellect OB a AcDl^'cfTlDn: nD autDmatlc final RKTURK character is aent » 

When the prcgram HAKE HDBD5Z Is RUN with HQH C, O Id effeoc^ you'll see 

Thia Applesoft pTDgrom retrieves W0Br»&7T 

MM-"". REH CTR,-<> 

IB PWlhT M^H ^OP^ 

4» PRINT M^^^mK^ UORDSS^ 

L rtih nes^ am 

80 PRINT t>t '^L^^^ w™?f>^^ " 
90 £HC' 

WhN the alin^e prngraH la RUN with HON C, I» Jn effect, yoo'IL «« 

In Integer U31C» c^vnao ten qepflrate multiple lUPOT respoMes for 
nuncrlc Vdrlableft, but n^t fdr atrlna Vdrldblefip Only RCTUHH 
rharacters can separate multiple respo^^^^ when IU7UT uoe^ with 
■uUiplc: «trln( variables- in inteR^r M^^IC, thereforei th« prD^r^v 
RmTI^Vt VDimsZ will Assign the entlr^^ field 19 wordt, & coirrnitts and 6 
apacea) tD the Variable A1&. Then yOik will get the EUD OF DATA HBaaEC 
when there ia na field tD aaal^n A2Si 

Vn AppleBDft BASICf jdu can alsD u^e the GET cnivuncl tn retrieve d«tll ftfl" 
n tent file* ch^rncter by character- Thi« has the a^lvAntag^ that ypu un 

define prtT char^ttcr Hrking the dnd-of-i^rd, Ecit inatancep Th« 
fDl^DwLnft Appleaoft prngram aiaa CEtrleves the tent file UORDS?- 

In Tine Ch« CLEAR ccvifflaiid sccd dll vartdble£ {includLn^ I dnd 

tn Ftro^ Line ^9 uaea Appl^soft'fv Altcrndtc v^y of HCtclnj^ zo 
mL-3> (4 i« thtr AflC^TI todc for CISL^>. This flwthud avoids the invisible 
Cand un-^copVablel cnntrDl character ■ 



I't-'t ^ ^^^^ 

^ ' * ^ ' ^- WW TT«_-[^ 

\ [ 1 

J J ■ ^ ? = * E* 

I -i-Ij 
1_= 

Line St CET* DTW character at a tima £Ton the taxt fLle U0Rl>S2. whldl uafl 
OPEKed for REjWine in llnO* 5< Mit^ *B- If tba new characCer is neither a 
commB ndr a PETUBfJ. line 110 tdda the nev character Ed che ted cE the 
4tTtnj^ A5(I). Then line 120 fltnc^ the prPgrapL baclc to line to GET the 

next character* Thii&^ thu progrffU builds up the flrat VDrd, ^^harJCter by 

Uhftn A cmui 1p Found the flrat vord la Buded^ ac Cine M a«dB tha pTDgrjini 
b^cV to line 79 to Increnent 1 and start collecting d new vord Jn AS{^>' 
And Finally, a R£IURK character (RS) marlca the «nd of the fl^Id^ 

ao llfk^ Ifltf eend3 the prnsran on to line to CLOSE Ehd flic dud en<l tKe 

prn^TdH- Tloce the uu o£ In line 3^. You cdntiot directly type 

a ^ETlrRH character into * BASIC praaraa Une (a typed RETURN end* a 
proglTAq but CIIRS(]3) is a RETUEttJ chdTdcter 111 AppLeaoft- 

Uhan GET obtalnA dharaCt^rtt frtm the disV, thfSt tharacL^rJ dfC HCt 
diapl^ed an th^ titteenp «V6ti In fOU Ch Iw D nade. Line LI^ has been dddcd 
tD let fou see tha wards a« they dre hulit up. chdJracCrr by dldTtCtef^ 

AEter dn AppledoEc CET cooimand tates its responBe from a diskette text 
the fnllowlq^ problem Arise: 
I) Uich C.t.O the flrat character PRIKTed efcer ttta GET 

will not appear the s<:reen- 
Z) tflth HDN CpI^O the flrat character PBIrtTed dfccr che GET 

vlll appear on the ncreen- 
1) Id either ndOp if a DOS coaraand la (he flret Imtti PRIKTaI 
aftet the CETp ^he T\OS cpnvnd Hy not be executed beciauae 
Ehe HCeagary ptat^edlcg REnJR[] is miaslng. 

In the pragran GET WRDSZ, the non-prlntlng "throv-dwdy" charactt-r CT^-A 

iT$) Vad placed b^ore th^ Eirst dealred PRINT Dharscter In line I L^. 

This telc^a cdre of prt^blenu E and 2, above* Td cure problen 3» the RETURN 

character wqs placed before tho PRiKTcd HCS comnand in line 13P» Huch 

aa wjaa done with TWCF fdQ# 4ft)- 

When this progran Is IWH with HSU C, ]» In «£EtfCCi you irlll S» the 
ft^llowlnil (hut alJ displayed in one cpiunnt oot tbree); 



t* It a 

•r tw oi> 

A^p MX GOD 

aipfi, Dom GOO^ 

HFPL£ DOWIW QOTSE 

MMn En 

BAMFHA EWL IC 

eraL£ ICl 

CUTHL »WI J 



And ldBCl>, here'^ sn ApplesofE prDgran thai CTeSLOS 9 file VDRDB3. With i 
vords Id Chn firil Eield» 3 iiDcda In The BECodd fltld. «ad 4 Hords In tliQ 
Elklrd lieJ-d. 

£ft - &fW Htn C«!t-D 

40 FRIHT t^''tmiTt. H£*PS3" 

IT 

M PKIKI 0» "CLOTHE WVZC^J'' 
The tlrtt field vill contsln 

APPLE. QAIUNA 

la 13 bytes Irmg, one pet chardCt*r {coeh^R must he counted CDC) plufl 
rni> for the RETDUa character^ Th« e*£{nld field, 
CA TAlilC^DORHANT , EAGLE 
in 22 byctPi loriR; the third Efeld^ 
rnUI T , GOD B E p EAT » ICICLZ 
la 2i bytas lon^^ 
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When tm with HON C, 1, Jn eCfoct you'll bae 



111 1 *■* ■: . 

.J = CHR» t4J Bfn CTBL-0 

60 !HPUT T*. V* 
79 :«PUT I4», >Mh V».. Zt 

Uhaa RON Vith HON C, I» a Id Effect^ you'll see chE folloulnei 

?rtFf*[^, BflN>*R 

^WIT^QOO^. urn, ICICLE 
CLOSE HOtflJST 

Th* prograDB lo HEAD the SEquenEidJ te"E rUOB WOUrfSt, WORDS?, W0I1I1S3 werE 
carECllllr deslgDEil to SEAD Exsctly the i:DrrEct DunbEr of EIeLiIb and Ehc 
COTrffCt numbEr of Itents per field- In ^EnErdl , a pro^Ean Eo retilEve a 
text file DuOt be deBigaEd around tbE BpEcfFli: FIIe, IE you maiE b 
niL*tak(, the EEBultB can appear soDEuhat fanfMalnfi- fcr InsCaDce, 
i:onHld«E the foLlovLng "wEong'* pio^raB to letilsvE the words in tent fllE 
WORDS :i. 

ao FHITJT -CLOSE MORPSl' 



HJlh HOH C, T, Id tffEct, htrt's u^I you iiauld qn aUHnlM IhB 

progroD- ^ 

?HP*^.E> anHHNB 

'PIJlllT. GOOStHHT. ICiCLC 

Tht IHFUT cfHund In Hn. 7# caused the MticE field dontainlna 
n[UlT,G009E. HAT, ICICLE "■'liHB 
EQ bE BEAD IQED Eh« Apple, ThE firit IhcEE UOtda verE AMlgnEd tp ChB 
.^"^^^^t!! ™' " ""^ ■^''^^ triable CT^ppondfna tc tbE 

EKTEA ICMUHED 

la diBplayEd, and eHE[;uClon contJ-fmOH, 

Hera is afiotJiBE "umdr" progiu to BEAD FhE cent tila vaRD&3: 

not fetrifievc tmm>s3:c 



3» 








PBIMT 










« 




Tli> ilt- VV' M* 












!>•■ "CLOSE Ht 


w 







And hcra la a MOM C, l, Rlffl of cha prugraH. 

e^O OF pflTH 
SUI^K IN 79 

This tlM, line fiff cautad thE fiald 

CftTflLOC , DOBKANT , EAGLE 

to be HEAD Into ihE Apple, ThE fhzep wurdB ace aHBlfnad iQ t>iB vflFlflbles 
TS, U5 and V3. flut line 6«'b IHPDT L^omflBDd ewpeciPd four re^pcmflta, bo 
It causfs thE nflut conpletc flEld to be HEAD into [he AddIe: 
tHUlT , GOQS E . HAT , IC ICL E 

XhB first word, nuriT. IH aflfllRneiJ to Hue el'a lant varlahle. tfS- ThEre 
flfE Tio bOEE vaclaWea rfth chia IHPCT cmmnaDd, hd the BeftBaBE 
ERTHA IGKDRED 
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Jh dlAplay^^ and execution coDtinueo- Thore ate do more CUIds lit the 
f1lc» ao line 7e^B INPUT COHuind cau^v th« 
EMD 6P DATA 

niE>Aaa£Gf jind Che ptcgru cnu to a stap^ 

A Boncuhat »orp ^eaEral pair of pro^raM, HA3fE TEKT and BETRTEVt TE>iT arc 
dlBcUBflrd tn B Later Btc^tion^ l^ey llIuBCtdte hou to nwkt 1 prcgtu 



OPBI-MG AND CLOSE-HG SEQUBmAL PUIS 

SpqucTtLiaL teat files abould be used whtn inEcrmatlDn 1b to fae retrieved 
In Jl llnvar Eaahlon froffi chc bcginnlne to ttie end of the fJlc, And vbcn 
Inf C? iHDa 1 1 G Q daea nol rcdJulfG mucl] updating an^^alng tdvldlDGi Fcr 
^AaiaplG H a atqu^ntlal file i^ould b« oeed CO {^[^ntdin d^La for a 
V^rd-guedBlng AHme^ ^^i In the preceding aanple prQgraildi 

T(3 cr^dt^ A BequentLsI cbxc Elle, tht CDHtands 
OPEN 

PHIKT 
CLOSI 

0r« lued* tn the order ahcn'O <t]l4ug]i nnt neceaBarlly right aftCT each 

Pthrr)-* T{» retrieve • Bequentlal EgeL EH^^ the CODiUrtda 

OFEU 

Are uaed^ Again Id the or^er ahowti though ndt necesaarlly T^i^ht Alt«r UCh 
OChf^r. Both prt^f^Ddnrea are llluBtTated In the prec^dlnK tectlod* 

A certain ritual la required before and after ycu create (WHITE) a 
Aequentl4] ttKt file: before udlng the file yo^a must OPEK it- When you're 
done^ yim BUBt CUlSE it^ The same is true when retrieving [HEAningf a 
Afiquentla] ti>Kt file: OPEN before RElADln^, and tLOSE the file when you're 
di^ne* 




FllcB that hiVC been OPEHed iliijJt be CLOSEd. Failure to CLOSE □ file that 
Was DPEWed and written to by a UR[TF Command teBult la loaB of data. 

The EyntaK for Ehtae tDrnnandB ia Blpllar to ether [>0S Cc^oHnandft- 

I [4otF: GPEN and CLOSt arc alBc) used vlth racdom-HQceag file? Bee 

Otdpter $. J 

OPEH f I.SaJ [,Ddl I.Vvl 
CLOSE [I] 

E}c■■p]«a^ OPEN SESUffi 
CLOSE 

CLOSE HQUTHED 
CLOSE tflNDOW 



OFEM a^^te Aiilde wnrkBpAttf In the Tor the fll^ t (foe thod^ who kncrw 

abnut such ^tuff^ QffV A]l«at«B A t9J-byte Eile buIEtr to hafulle thl^ 
ffle'a Input *nd QUtput], and Rets the Bysten TB^y to read or write frcm 
the be^lnnlna cE the Flle« OPEN aleo d4>tlf up th« alct ftod dr^e niimberA 
to be used by the subaequerit U^ITE [or READ) i^oBraTldp 

The CLOSE cooDuind relsaaeB tbie vorhspace Ln ttl« Apple (de-aJ locates the 
flte buffer aaaDciated with the file f ] > If ( la not fipCcJEled, ftlL OPEN 
filcB will bo cloaed, with the exception of any filt belflg U91^d by the 
PXEC c4Huund- V-HEC fllea are dlBCUBsed Eater In Chapcer 1- OPEN 
aouetljne? CLOSEb tOCC OPEN firai checks to see If the named file is 
already OPENi If it C^OB^ It before re-DPENluK lt> 

Nota th^t the CLOSE t(»Titndnd haa M Drive Blot parowterBh If you typa 
CLOSE MYEILE 

then any file nained HTFIF-E vill he CLOSEd, rAgdrdlcOfl of thO- elot and 
drive nunber aBBOclatdd with tha f]l«* Slnll«rlyi the cnnand 
CLO?E 

vlIl CLOSE aU fllea fexcept a file being EXECfid) on al^ diBk drlvea. 
In various clrcufnatance^, you My w].sli to delete a file f that nay or riEiy 
not exlat b This la eapeclally InportanE to avoid probleuiB i^f Avervrltlng 
an tild IHe funlee^ yon overwrite the entire old file, part of the old 
/lie will CeEEaln, attached to the tfnd ot your new file). Suppose fl ftflfte 
erraCclJ and udeS the file &C0ElE5 each tins It la playedp and yOi* wlah your 
praHran to delete any old Elle by that ndme dt the atart of each new game*^ 

The CDDiBand 
DELETE SCORES 

Will tause tbc error meaugA 

FILE NOT FOtnOD 

it the file doe#r>^t enlat, and your program will halt- Here's a quick way 
t<J delete any file naniDcL SCOEES atlJ re-OPEN It far new datd, whether or 
cot that Elle already exiata: 

S Ben S-TSBES PELETEfi! 

IB W ^ raff Pff 15 CTJiL-p 

2» WIMT D»i '^DELETE SCORES** 



WPntE-MG SEQUBmAL Hi£5 

IK' re Lb another program vh Ich createa a aequentlal tent FIICp This 
Applutjft progran tr«at«a d text File nflmed SAHFLE which conrdluB 3 
BtrlFipQ ndd IS oumbfrB- 

Tht ILle SAHFLE mdy or Mp Mt already enlBt each tine the proJirdm Ib REIHj 
If It doe^ exldt. It ihould be D^lETEd ao aa to reoHTve old dacj froTTi the 
flic. If It doed not CKldr And your pTogru triea to OELET£ it, yQU'll 
receive the Beaaage 
riLE NOT FOUKD 
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nd tht pruaran atop. Llnee d^d 3» tak* ear« of the prDblea- If 

£AHPL£ already exlfltd, line 29 OPEK» it and line DELETEh it* U SAflPl.t 
does not. ejlnt, ] tut 20 QTeflEew a file SAMPLE qnd Lint 30 DELETEp It* 
When Un* tfi cucuted it CfUtea a tleJin file SAHPl-E^ SO tht 

problen <if miud fllea it avoided* 



IB 
























fit INT 










P*> "Wire SHP»*LE" 






™jnt 


"HI MD": r^lHI "Hi 


HO- 






■OFF TO THt PI5K U 




eo 




■ 1 TO IB 




M 


WMHT 


J 




l«0 


NEXT 


J 





".TP rw' 

IIpte's whflt you EEE nil Cht BcEsEn when yau RIFN this praarAB, II HOW C, I, 
ifl in effecE. 

Ml HO 
til HQ 

0H= TO rtv: tisK ue co 

1 

1 
4 

9 

S 
7 

9 

le 



Before you WRITE a file, it msat be OPE«*di CUlSE It fqulelly, pleasEl 
when yilu're dcme. &OEh the DFEH flrfl WHITE cDBsada nuaC rtfpl to the aaine 
file HfiHe- 

Once Ji WBlTPr coTmnflnd la ^Ki^^uted. any aubsequCnr: PRINT cc mnuin d b aemJ ell 
<:>idrBcterB Co Ihe Hltkette, InaEcAd of the Bciee^i. A WHITE coinmflnd Is 
<'Bncclled by the uSV "f any DOS raudnd In a R!1HT sLflteliEnt . Even tllC 
"L-mply" DOS cr^Bmnd (Juat CTBL-D) will dn. 



«1 



Q 

An ItlpIPT cvnaand c\f rhp farn INPUT X$ alao cancels a VBTTE ccnuad, but 

only alter ntorlni- aa the laat te?(t Ille charACCi<r tlie ? which the TKPUT 
rr^DMtnd rtnnnaCly displays on the Bcreen^ If the fctrn 
IHPUT "HWAT'li YOUR MArtE 7 X9 

Jn LiUf^H, tllr URIt^ iB Unceled ftfter the chUBCten in chtt trrlQ^ are aent 
to tlie dJalutte- 

Q 

An ertoi nenllaEe i:BdC«1« ft WHITE cmfund. buC oal^ Alter thv entire error 
BEBJiBBe is aforEd sB the Iset Elrld in ycur tut file- 

The ayntaic for the HRITE coauund when uaed with Bequsntlal files lai 
WRITE [ 

[Koca: UKITE alan Lised with raadoH-accetB CilM, lai ChdfCer 8-] 

BKa^iloj: URITE LETTEV 
WRITE BICHT 

The Buple progESD givEB it the bealimim at this sectluB ia A eUpJi 
IlluirTaEiDa cf the mat baalr (BASICT} elements nCed«d LO create a t«t 
File- A Hllghtly Hre general Applesoft pEogEam fdllvd HAKE TEXT II DO the 
Syatea HaatBr dlB^tte ChBt CUM with your lUak drive- 

HARE TERT allwi you tO CKlte a Baiuentlal IEbT fll* contftlnlna up to M 
Btrin^s; Bflch ^ttLa^ tff hivf at mott 239 chflT4cten> Try 'it — yni'll 
llJte It fwe hope). Place the SysEein HaaEer dlaketCe In ypur drive and 
type 

LOAD HAKE TEXT 

A LISTing of the pnica should loak like chla; 
^ BEM nnME TEWf 

10 EMI p*#'.i">e:' 1 = e 

no D* * CHP» i4> FfOl Cim. D 
-►^^ pf^lNT 'VOU GET TO TVTt ONt ST 

ipjNti M 14 Tire " 

i^i^i pji-fJT -TkilSr raOQW4rt LETS VOiJ 
tffflTt TEXT RlES 
f^PtlMT I ' I • 1 

Jf* nriN^ TVTE STRlNtr •'■-J - 

{ CoDtliwed cm nevE pM^e } 
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(CDntiiUrd from prCvIouB pagE) 



pEDtectEd. fThlB BtEp Ib aecsBBacy because thia prDftran* Ilka Ehv ANIHALG 
pragran dlh:uHBed In Chapter A, creates a neu file-} 



YOU GET TO TYFE EffJE STPIWi Bi H TiKi 
A STOJNG WHY HPt^ IJF TO t7B CW^ft^TtPi 
THIS PTJDGRHPT LETS VOU WRITE TEMT FILES 



One* Eh« pirogrb 1« L(UU9^p SATE It □□ a dlekette that's npt v^iC(^^ 



- - -- 


















Hh 11' 






-J 






















-■fit 




fp?"." r - 1 




.1 '^v 


rL^ -J = I TO 1 - 


1 


















" 



la MAXE TEXT Btlll In your Apple? And a nQTI-^rritt^rottadd dIsketEfl In the 



drive? If ao, type ^t^^l 
MOS Ip ■ ^ 

BO yoi can aee the conBands a«t t4 tnd froh the dlAk- Then type RUtT 
And you phouid hc th* follDvItig Buag^c 



4- 



Typ« In 40 Hirr Ptrlngt as you lilt fup to Itfit vy lie entEred>> tfomlnR: _ j 

th? program uAea £0 doo'^C typd COuWJ or colOnA InCO youT SErlilgJ^ ^E^^ ^3 

Vheri ym vjtih ta quit, Juat prAsB the KEltlAH key Intead gI typing a 
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Ch00B« a none for your t«t pre^a the RETOHK fceyp and aa ytmr atrErg^ — i 
are 4adC CO the disk you'll! flee thn printetT the Screen. First will 

appear tha dtah toimaande ^ti 

OPES E ^ ^ 

DELFTS £ 

OPEN f *i 

WIT£ f I 

(vher? the f la replaced by the file nane you chcwe>* They'll! be fnlloued by ^EIl Z3 

a nunbet — the nuTiber aE atringe vdu entered Inta the file* fThiA ITS 

4 
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mtrolK'T UlU tFL' kpaed by a plDgram H^lB<'Uaaed |.n the nEHE EDdtton thnt 
reEElDVeB your rHE>. Kent ydu'll aee your Btrlnaa. Fiitully ynu'T-l aee 

Here's a Baliipl.C bVh of Ehe HAKE TEXT pTD^TAP; 

IHI^ PPOtfrtflP L£TS VOU WPITE TCM FILES 

ViJU t£^ TO TVra Om ST«IHQ BT ft TlPt 

H Sn^™0 »lf*V HflVE UP TO 23? CMfliOlETePS. 



TV** 5TtiNe *«JfC-S STRING 1 

<Ta eUJT. F^ffiSS PETWlfl* htV FIRST? 

STO BUIT. PWESS BETURW «i¥ FIff3T> 
riFE STWINS BS. OW WE 130 

£TO WJ1T= PTOSS f^ETt™ KEV Pltt$r> 
TVPE S"rPlf«e M £NOUQH RLPEPOV' 

(10 SUIT, P«SS 6*7URH kfiV FrRET> 
rVPE STHINO #5 

MMfiT FILE WnC TEST 
fiPCN TEST 

DELITE TC^iT 

EPBi TEST 

HPi'lTE rE5T 

4 

nW* «V sect** STRIfra 
□N W OD 



II yCTu DPBN a text file that already citUCs >nd then HUlTE to ic fviChout 
lifftt DtLETEiOK the llle and re-OPBTHPB ltJ» then you ^±11 overwrite at 
leoHE A portJ-Dp Df the tile, UnltU ypu cvervrlte at least aa rurny 
charactrra ab ^xlated in the old tllcr the result la that the at^^ file 
contenta vlll hs 4 ntx of the data PHIKTviJ to the Elle en the tvo 
occaaicnb. fltrat vill Appear the nev characters you FRTNTed to thf? file 
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Llilfl tEoH?. and tbien will foliov any portion of the old Eile you did nnt 

oLd file before you OPGTI it qccV* (Id the prd^rEn HAkU TPICT^ MnCli 140 
and l^fl kdk« CATt ot "cl^ntn^ cut" any prpvlnua text file by the bbms 



READ^G SEQUBfn AL HUS 

The DOB coTmnend READ ellcnrs yoLi to retrieve a text file. Onize h KCAH Ie 
executed^ any Bubsequent INfUT EtatemBnta [or CUl^ in Appleaof t ) rpirr tn 
tha specified file instead of th€ Apple^B kDyboard. ThiA Applesoft 
proRraD retriavea the teKt file 5AHFLE created by the pragram lifted at 
the beginiiina of the preQedlDg aectioa* EtEAD^ like VRITE, inust be 
pr«C«led by DPEHIhb the file to be u^ed. The file nu^t he CLOSEd as well- 

1^1^=^ chK* <4?z pen cwf*!^*;* 





PWINT 










■» 








J 


- I TO 1* 






U 















An OPEN wuai pcerede a HEAD, and pn THFlfT (nr. In Applesoft^ a GET) "uet 
foElcv a READ. The OPLN and RfAD muEt teIet to the bbh file nfllV- If 
you HUW the pHTgEflHi Uirti HOH C, I, In eliect pQu'll tCC this: 



^1 HO 
1 

■M 

TS 
?7 
79 

CLOfit SHHPLP 

Th* tiTDgru «■ vri1t?n EKpllCltly with the SAHtl.E Elle In mind: lE 
aBBunea thaE The t»C flLe contplna ] amEnBa* CA&, BS, and CS In Line 40) 
ami 1# Inlefters (tJ In line 69>' Two qu^Btlun urlu aie prlnEed when 
and C5 arc INPUT bacauic BETUBKa HpiTiEad Ihc JNPOT'b wJtlplf zea^anBBB- 
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A KKAD rornBind ia ir an i: l' I li-d hy thi- ufle any HOS COWind En a HHirtT 

HlfltEVnl- The "empty" BOB [:nimnBnd fJurrC CTRL-Irl ulll iTn JuaE fine. Use 
of thF PKl of JUt rnnmmnda also cancelH a VEAD. 

The Bpntu foi eIib lEfiAJl cenund In the aane bb For UFITB: 
HEAH t 

[HDEe: READ la bIbd ufted Wltll TAildon-4 Ct: aa b Ellea, aee CTispter S-] 

Ruflftplefli REAJJ LETTER 

READ CAREFttLLI 

Stopping a HEAI* in AppIeaoEt ualng CTlflr-C wiLl generate a string &f 
KEENTEXs. To av^Id thls^ preas the RESFT key to atop the progrfltt* 

An Appleaoft progtaiii thst retrieves tert Ellcfl cr«.lEcd by the MA/E TKtT 
prnBram Ifl on the Syaten Master diAlcett^- l^]aC« the System Waster diskette 
in your drive and typfr 
LOAD RETRIEVE TEKT 

then SAVE the profiran on the 0ar» rfiali^tte yau usad Far HAKE TFJTT, iThe 
pro^tAt] ift really a cnnipanlon place Lo HAKE TEXT, and it"* BiAply DAn 
fz DnVeti 1 t to hne then on the sane diekettE') 

A LISTing nE Che ptOBrnm flhDUid wpear as folloirti 



i4 ^ ■ 'THE CPfcfTE 

■ 

ihffUT 1 

55 j^li I J 

FOP J - 1 TO i 
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Mow typt 

hUN 

and yau nhauld ane rotSiO^V 

IKEnTED 0V THE nH|i£ TOT PAiOOIWR 
ttM C. t,0 IS IN EfFECT 

Tvp^ In ihe IL4IDT nf the C«itt EiJe you crafted using (he MAKE TEXT praRrain, 
presii itie RFTURN k*ji, tnd you jhould ht eft qnd rMrmlug foopB — taihor, 

Hetv'b what ycu'll fiBfl if the file TEST^ used aa a Bsaple at EhE end □[ 
the last uectloDp IB [Htrie4«l ubIdK the RETHIEVB T&XT prngram: 

cranTEP Bv Tw 't¥*x: text pooonw 

mm C- l.O tS IN rFFECT 

WWE Of TENT FILE' TEST 

tTO» TEST 
«ftP T6ST 

tM HC CO 
ClCet TEST 



MORE ON SEQUmriAL FUS: APPBID AND POSmON 

Thn? DOS comMfldfl APPm) i^nd PQ5ITI0M, respectively, allow you co add text 
th^ «nd of A sfcq^pertt laL text tlle-t ^nd ta access Inf arnat ]on fraa eny 
Bpecl£led fic^ld vlchEn d t^KC tEIe- 

AFPEND alLcTVE ydu Co add datd CO che ond cf a BBquEntlal test file. 
Thig 1e particularly Li&cEul if you i^iEh to extend cTic InEcrsBtlOQ In d 
Bcqucntial tcXt Ellc. bc In the AT<lMAL5 ptogram dlEcusEEd in Chaptet ^ 
could hHve» The CDimnand OFEH, ynu vlll recall^ alvays Beta the 
poBltlon-ln-the-f ile pointer to byte 0^ tho Flrat ctiarActer In the file. 

The comflkand AFFKUD perfama an OPEN far you m e file that aUr^fldy 
i!3^Ltft&i cheD B^ca the ^^odltiOd-in-thD-I i Le pointer to nne byte beyond the 
IflBt chHtacter in the 

Tht fdlloi^lng ptngtdm bulld« a f J Lc tdlled TESTER ttidt cOotainS the CVft 
attlDBB ^TESt fl" and ='TE5T I": 
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^ (VIKT -Ttfif 1" 

the EnllolriiiB pregrm AITBTOb the atrlngs **TEaT "TEST 3'^ and "TEST 1" 

to the file tEflTBftl 

S WPEHO TESTER 

lO M - CMM C4^, (REJ1 CtPU-O 

^ Mi TFSTEK* 

4« M»H4T -TEST 

f«i>#T -TEST 3' 

PSlhT "TEST 4" 

The folLoving proftrn dl»pLlT« the file TESTEBl 
lit fifm ftETItlEVE JESTLK 

40 PRINT &«J "PCHt^ TCiTER'* 
TW FOR I - 1 to 5 

TIB i 

AFFENO iPuftt be followed by WITB tdtt^nrpc Ivlg to READ vlll Juit H^inse the 

DF DATA Be»aBe}» The ayntajt for Che APPKHD coimand id doubC^^da 
EaBlliar If y{»u've been reading EtrdlahC tbrotlgh this masuaTc 
AFFETfD E USsJ [,Dd] I.Vv) 

j^PEMD, ev*n thoLiah it 1b used only for HlITElng into a text flle^ doea 

rtnc cau^e the 
ULE LOCKED 

u^^ftfiflfte If the file Ifl iMtud- That message Is givtm only If ynu attempt 
ta actually WHITE to che flle- 

Thc DOt^ fQBmafid POSITION allow* yOu to WRITE or HEAD Information bt^MltinJng 
In any fllven field of a BtijuerttlflL teit file, Thr syftCflx for the POSITION 
conand la 
POSITJOK t [.jlpl 

where Rp ia the Belttlve-f ield ^oaltlon. Thla conmufid apeclElea that 
DDS'e poalclon-ln-the-f lie pointer will btf BiOVe4 forward fooly) to the 
p-th Held ahodd of the current pointer pDdltiori- It p^V> the following) 
RKAn or WRITS btftlns In che current field. If p-l^ the Eollnwln^ RtAD or 
tfHm Bklpa the current field and b45Rina Le the nggt fl^-ld- If p-J^ the 
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folTuwlng BEAD or WSTTF. eklpa t«c. fields Irtcludine Che currefit fieli, 
befote b«[-lnnLFin to REAU ot WRITE. JVnd sd qti- If your file does nPt 
rDnCflin aD^- FItjJcl ror respond to the relative-field poBltion BpecifLed 
by the F051TIOT4 cninnidTul» the oeBBd^v 
END OP DATA 

wJll bt dlBplath|±dr And prDgran eicenuCtOD vlll fltop^ 

WBiTIDW with the Rp parameter Bpf^clflea a reljt Jue field pasltloa^ p 
IlcldH ahead o( the current flftd^ POSITIQH must refer En a tile that you 
hive already 0?EKed, OPEH autoutU^lLy Betb the poait lofi-ifi-the-f 1 Jo 
IKiinter back tt\ the haglnnli^ of the flrat fleJd- thu&» if POSITION i^ 
ua*^d liTHDedlately after OPEN, tht relative - field po?ltto[} fllM 
correspnnda to the attual, or et^^oEote. Eiftld poBltiou- In no other 
ra&e ta thlfl fcruS, 

Lihe any OEher DOS comund^ POSITION C4ncci]s a READ or a IfRIJE, Th«efort 
POSITION muflt be used before the iSSOclated READ or EJKITI^- 

F05IT0H dctualLy scflnfi the contentB ol the flle» hyte hy byte^ Iwkirtg for 
the Rp^th HETURN chaTflCter- If, durinft thia procMd. it enQountera an 
'Vmpty" {val^ 0] bytCp the KBOlge 
END flF DATA 

is praserit^d immedlBtelv ^ It Is OOt necessary to ICCbJlly INPUT dC GET 
any ^uch nuH ciharncter- 

Here Is a prQ^ru that uses Pfl^ITICW to r*critve variaua fielda frfln the 
TESTER file, crsdted earlier by the MAJE TESTKB and APPEND TESTEH 

« fVlUT "PDiSlTIPH TESTER. RJ^' 

tie jww rw 

^ INPUT B» 

lia PRINT "P05lTiO« Te5TtW-« 

41 

120 PHIPJT £>•- -*«flP ITESTEff" 
14JB IPJPUT 

iS* PttNT I>9, "CLOSE TCSTCtf- 

If ynq RUN thl» pirDgzani ulth HOT C, 3, In effcff, yoii will see; 
OPEN TESTtP 

ttftO TES'fER 
'■TtST £ 
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TEST 2 
^FfSr 4 

AiE you BurpcLfled at Thv rcBulTB? Hwtnber Ihac the curr*nl field ia 
celative-f iEld pDEition nuinbei: tf> AlsQ. r^iwnbvr that «dch ISP^T cjujftCEi 
ant fldld Co be HEAD inta ttie ApplE« and bOvbiiceb the 
pas Itton— ia'thE'E He polntET to tbe bEgEnnlug of EhE DEXt fletdr 



nm-MGOfFMORE 

Note: the foltoVlng fitctiOn in d&t fot htginnerEr and Bequmtidl fllu 
can be ued perfectly well without « tno«ledE^ °^ the parametera dlsciiBBftd 
h4rr«. 

The DOS cnnnnands URITE and READ can be used vlth a Byte parainetnr ti> 
VRITE. or READ [nf o rma L 1 on starting frooi any place In a text file — ■ ij_ 
ycu kflOV vherc that place is- Th^ trick Ifivolve^ kTiowLlifl aL exactly vhich 
bytr. m the fUf ycru w^Ot m 9tdTt (^ch byte conralna one character''B 
ASCII COd«l- To dcp LhiSt yeu mijst Lmau eicactly how you have stored 
Information into ch^ fll^F Vou Busc count all RFTUR^s, ranmSh qpaceo end 
other characters In the file vh^n flouring out ^hf^re to bcHin- The 
problem 1e even okorc dlEElcuLt for Wl^JTE, becduse you Eu«t dlso knou where 
to end- 

The B persHter li an Actual or Absolute pojitlon 1a the ElLe unless R la 
apficlflddp If R It Klvan^ the B paraneter Is the actual p<>Bltton within 
the specified fields 

Tht cnnmand 

WRITE THISHtPNTH, B^7 

sets the posit lon-in-the-f lie pointer to the tWcn t y -e 1 fth th byte of the 
file named THIEEWHTH (the first byte ifl nuftber Hi- ChiiriCters aent to the 
dllV by a eubsequent PKINT coomiand vll] replace an equal number o£ 
chJira^teTA that already existed if\ the flle^ hegl^ninK with the chatsctbr 
{n the 2ath byte- 

X 

This ovcT-vrltlns la not costined to the current Cield- If yov PRINT 
tewer than the nujsber cif thamccerfi reulnlng lit the current Eieldj you 
will create two nev Fields^ the field you just TttlHTcd, fcllovcd by the 
tail-prtd Cf the field you were aver-wrlting. If you FRDfT mote thdn the 
i^unbi^r ot charactera remalnlnn in the current fields you will over^-vrlta 
Bon^ of the characters at the Start of [hc nent fLeJ-d; the currerit field 
will thf^n be IcTiger^ pod tbe nemt field shorter chad before* 
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It 1e alfin pchflslble to VRIT£ into bytes that an beyond the last byte nf 
an dkI St Lng Eeriuontlal text f lie ■ Ad sttEiipt to READ tbe lnterv?ning 
Lio^rltten by tL'a vi 1 1 cause the 

rHBsago to be dJaplaytd, and your program Will «ti>p* Stc the diatusaloi^ 
or tXAD iilch cbo p^rAn^L^Tr Toe Lnforiutlon an Accculn^ ee<iuMtl9l t^xt 
ilic tii^ids chftt art noc next to each cttter- 

Tht syntflx fQt thts CDRund Is 

yhL're the D pArsmeter ^peo^flea the file byte at vhlcih characters sent by 
rhr next PRINT cdHund vlll begin repLaclnR tHe characters. The default 
vnlue of b Is ff, tbe flrat byte In h File» Byte b Is dn actudl , dr 
db^^lutr. pd^ttion within the file. The b parameter may apecify a 
pn^itlon either bcfortt or sfttr the current posi tlon-lTi-the-f lie pointer^ 
[Note ; thla conmaDd is also used vltb randoir^^accece fileei BcC Chdpt vr bp ] 

SimiEsrIyp the coTtrm^nd 
REAQ LASTHONtKp B32 

aets the paaltion-in-the-f lie pointer to the thlrty-thltd hyt« of ch« file 
fi^roed UlSTHE}NTH lagaln, the (IrSL bfCc Is ituhhar 0)- A lubvequent IS PUT 
ErDOKiand will cause all cha fa t C c 1 3 Ln th^ next (I«](L <l-e- Up to the next 
1t^UT<N character), hefllnntng vith the character whose ASCII Qode Is stored 
iff the file's 33rcl h?te» to he READ Ipta the Applet If the 33rd byte doeB 
not contain th« ElrAC thara^rer o( a If^ld^ only the revlnlns charscters 
In that field vlll be BUDp 

5ynta]i for this conrnsnd Is 

vhotc the S pardificter speCifltiS th« fild byte where the nrXt IHPQT OT CET 
CDHmand will begin reading cbarsctersi The default vsLue ui b is 0, the 
first byte In s ffle^ Byte b is an actual , or abeoLuCe, poAltiOd ulchLrt 
the fiJCF The b pipraneter nmy specify s po#ltl^n either beiore or after 
the current po^it lon-ln-th^-f lie pc^interp I Ncrte^ this conmand in aJe^q 
used with randc»[^scce£fl flledr aee Chapter J 

The folloirfpfl proAFQB ^et& the pesltlon-ln-the-E 1 polfiter to hyte !fi 
{the fifteenth bytet In file TESTER^ tfhleh wsa creqted earlier by the 
proftrAPi MAKE Tfl^TEJi- Th^n i: Whim ihc tttrliiR "APPLE C&iPUTER". Ntce 
the fanLlllar sequence! CPEHp then URIT^ sad fRlHT, dnd flndllr CLOSE* 

^ REM BVTE URITEP 

a» PtfitfT "^aPCM TESTER"^ 

» PKIHT E*J "CLOSE TEETCB^ 

tflth HON I» □ In effect, RUH RETRIEVE TESTER to see hov the pteVlOuK 
prnersD has changed the file TESTER. As you csn see, the field cuntslnln^ 
AI'PLE CC44PinER has completely over-vritten the fields that contained TEST 
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1 onii TKST 4, «B uell aB the fiTflt charflcler oC the flelil iTiot CCEItPlned 
TEST 5. fLfl there are rm* oalf four Eleltfa In all, Oie EWD OF RATA nwaHiBe 
una dlaplflyed alter the fifth IrU'lT qoinmaDd. 

Thf lolLiiUlnA piDBram HfEB r> pointer In bfie 18 in the lllr TFSTEB, jMt 
wtdLlU'il by the prcccdln^t prog*™- Thin Ihia prD^ran HfiADp to the next 
KEimn in the file. Again the fanillflt iormat: OPEN iB EoHm-ei ty HEAD, 
nenl come INPUT »t«einenl» (or, lo Appleanft, CFT» "ay be used) and 
finally the file U CLDS£d. 

5 *iCn fieVTE 

IB M « (4J WB1 CTft--D 

M #T;1P*T t't^-OP^ TESTER- 

» PRIMT E*>-REH& TESTCfcBlB' 

PRINT &».--CLOS€ tEST»f- 
Try to predict vhat yoo will see, befarc yon RDH this progrflv- 
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CHAPTIR? 




ram 



7b t^pcuirlha Pr^grfPOH In 4 Tut FIIh 



Tc bflCttfr undEfStand eKe ccateaLa oE ttiia chapter^ it ±a Bue^eated that 
you firat read ChmptieT £| on flCqocutl-Al fil^tt* 

CONTROUJNG THE APPU VIA A TEXT HUr EXEC 

The UOS c^RTm^nd EXEC is aimllar Eg BUN^ except thaL the dish, file uBed by 
an EXEC ccnDuncf in a tcHt die thAt contains coAim;4fidB cr prchgram llnt^, 
Inciluding BAB1C a t e tenen » ¥B it the; Vflrc typ*d At thfl kcybodrd. 

To Initiate a d^nans C ri C ion of flOlu EXEC cpfmund «blllcl09» 

LOAD EXEC DEHQ 

ftDB your EyBte^n Halter di*^ic# 4lhd thttt SAVE it M a dilkatta that*> tlDt 
vrl te-prctected . l-^Ave th^ ufl- vrlte-i-prP t ect ed diskette In the d^ive^ 
aincc the pTDRTani WtTTPfl d t«t £lla- 

Ncnt Rtffl the pro^Tqn- You should sh the HBaegfl 

^^ Cj<ec mho » 

mis FWGBflrr ^jREHTES R SEGUeHTIHL TEXT 
FILE Wr)EI> "I^ eP'' CCMTOIMHG SEVEML 

5n?i*«5. emn a UEiiflt pthji it rowmw. 

WEN VOL* TVF^ 

TrCN T»C CONWM?S IN FILE M^EB TWC 

MTU, BE EXECLfJtD JUST ftS IF IT HRC^ fiCEH 

CCSCVJCES TM PPOCf^An LN rtWC DE'miL 

« t«PPV E^Cl^TJND » 
PWES3 rue SP«^ fHSV TO fVttC THJS 
PHOfl»»l C^fftTE THE FILE TO^CK. 

IF vou WISH TO 5rop Wis fWQWri h(m. 

Wtt WfV PffCSS "« KEV 

PreBB the Apple's sf«t« bar, and aFtAr a btlaE panAa jon ahauld Aaa the 
disk, drive^a JK VSZ light ^otnQ m aa tha progrui urltat the DO^£R file 
gqLq the diskette- Vov type 

prt^H the RETURN key. YQur Apple will begin a sola perfarnanc^ haaed Qn 
Lhe acrlpt in the DD'EB flit- 

Here's d brief auramary of the major things DO'ER dueSt 

Flrat DO'ER iBBtie? a HON C, I, coHmand^ bo you'll he able 

to Bee vhdt happens. 
Second, a three-line prOftraiD lA written and saved on diskette 

bTtd^r the name HEV FEOCRAM! 1 Jhe prograB is then LISTed^ 
low a POR-HfiXT loop ia executed tc take up SWtC tlme^ BO 

yna get a chancie to looi et the Bcrean before ih* 

ac:tlvtC}r contlnuaa. 
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^ NPJtt PO'^E!! uaes the INT comrand to enter iDt&ger MSIC, 



^ LOAhB th« pra^ran COLOR DRMOS^ 4nd LI^Ts 1t- 

Kl thlB point, DQ'FR ur^r« CALl -155 t[> enter the Hnnitcr and 
flxrciitea boiv= mArrh In^-Ianguage instrncLloDB hefore using 
the F? cfiHoand to enter AfiC^Iesoft- 
frob Applesoft a HGN C,l,Cr comoand is ej^ecuted, then 

HHV mXdKAHii Id RlfUp modified, LISTed Ugain s FDR 
loop sllowa you to take ^ lock at the screen) ^nd SAVFd 



I lABiiift the nanc EVER HORE RECElfr PROGRAHE] 

Kl IrBHEly, the pronrdm Til^ PRDGRAHll Is DELETEd and the CATALOG 

I ^ [including the aew addition EVEN HORE RECEHT PROCRAHH) 

_ dlnpiayed- 

?J *nd you won't even hnve to lay a fingat on the keyboard jnnleas ynur 

I CATALOG haa more thsn LB entTleq, In which ca^e you fieed to presB the 
space bar to Bee the balance of the CATALOG entries^ 
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^ CREATHO AN EXfC HL£ 



Hert-'d a Btep by atep eK4npLfr to lllu^trete how to create an EXEC fil* 

nsned DOIT that contelna the Eolloving CQDSumds; 
LIST za, 5t 
RUU AUAY 
CATALOC 

Flrat creete dad SATE an j^pIesoEt pfngram cialled AHAT to n&e in the abtiva 
cf euions t ra t inn i 



•I- 

Ktiirt Vrite snd SAVE the following proarain, called HAET EXEC, that Will 



l4d FRiPJT -»dRV WnV UITH RUH BV 



ctsste a text Eile called DOIT« Uben you later EXEC DOIT» the CDomands 
ycur HAKE EEEC program haa FRINTed into the DCIT ra>iC file wilt telL Apple 
to BUfJ the AUAT program for you- Notice that the camnsnd? which are 
PHlNtad into tbe DOIT filep for later EXECingp ar^ not preceded by a 



Ze PRIKT Mj "OPEN DOIT" 
m PRlHf W. -MHiJE DOIT" 
« FfUHT -LIST ^fl^rw 



After you have HAKK mC JUld AHA¥ both SAVEd on a dlaliEECe> type Ebe 
in crpdtv a aoiiufarial ccit file DBmed DOIt- 
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to cauBE the ccnmqndfl Ifl the file DOIT to bc cneizuted one by on*, JtiftC i^s 
If they'd bHn typed in fcan the keyboard- Again^ Dctice thflt the 

CDHAnilfl now being EK&Cuted were not pr^t^ded by a CTRL-B In the progrEn 

HAKE EXECb. Flmi Lines 29 ttiTOUBh 5fl from the prDHram currently tn ■erocry 
tprcbably th^ pr^gtATn WAK EXEC> 4re LISTtd, Then Che proertn fUDwd 

*AHAY" ta BUN^ And finally the CATMOG On the dlAke{:te tm dleplAyed^ 



CAPTUPMO PROGRAMS M A TfXT FU 

Hera'^ 4 fjr fnote UBeEul exanple ot UBlng the ZXEC copMnd; It dlLcTva you 
to capture pro^rBD liatlnge texc fllesp Sucb q progrtn cm b« uaed Ear 

* crftnilatldg Integer BASIC progrAM Into AppL&Aoft 

^ teDUDbering pert? of progtdi^B and EXEClng them anyvh^t^ 
into another progrAin 

* Inaertlnp f^voTiCfe fiubroutlnea loto progrdPS fton a 

■ubroutlne file on the dUkette by EXECing the flLa 

* *^app«ndin£" one progFAn to ftnochpt 

* npdltlng pragrante th»t have bvcQne partially ^^t^eadablft 
<you can capture the good portion In 4 teitt file, re-boot, 
then EXEC the program portlDn hack into meDory) 

The line nurnbEts 2279 and Hit, fnJloving the ccnaiid in line 6 of 

the CAPTURE prDgraju^ Ehoold he TepiA<!td by the line nubara □£ the proflrAP 
In metDDty that ynu vlah tP Ciptur^P The name of the aetjuentlal t«Xt fllft 
containing the ICatlng Ifl LISTUfG. 

3 reiWT tW. -DPEU LISTING- 

C LIST iSr^ 5136 

Addo the line miaber^ of thlJ program very clo&e togerhf^r, bo that you 
can add the^e lines to a prograni qlre^njy In nebOty, or anywhere vtthln 
your progrdb that you have eight fre* Line numbers^ Tau could Juftt dS 
edBtly put all the lines of CAPTURE ^bove the hiabeat numbered line in 
your proBrAHp 

CAPTLiRU tredtcB a teit file contdlning conands that are preceded by line 
numberBi When you EXK thdt test file, the oti^bervd couraandB vlll not be 
executed. In^te^d^ Jiifit as i£ you had typed tboifc llnea in fron the 
LL^yho^rd, Ch« lints dre Stored aa a proflraw In Apple'a inenry. Once 
L^flpturcd in a text file, a pTOgrarTt CAa b? iDDdifled and then EX£Ced back 
inifi Apple's raeofcory- Unlike LOftlF or ll[rfl, EKEC doea npt dtlvte a program 
th*t la altt?ady in nemory* UgJng CATTURE, you CAn CApEuT^ a prn^ran in a 
text file Eroni one latifluaatj then tiCEC the proaran hflcfc luEO another 
Idnguage (of courae^ the progr^A mdy not run vtthoul ftomfi cbaugea — 
thvte^B soDeuh^t different sythCax £tir Iqt^ger BASIC and Appleaoftl^ You 
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can qIbo UBe EKEC thia WBy td i»dd ntw linea to an exlvtlng progran in 
iTWHDry. fn fflCtp you can aiV<^ a Uailng of CAFTITME in a tent file ndHd 
LtST SAITER, &ay, flnd then EJCZC LIST SAVEk any tine you wdflied to add the 
[^AlTUhfc proftran to a pro^ren in nMiDory- 

CON VERTM9 MACHMi-UWOUAOE 
ROUnNES TO BASIC 

Here's anullicr ue*E<il progran (ttar wJ-LL taltp a nachina-iaqRuaflF routlu 
and CDnVerl IE Into a BASIC progrArD portion vliLch PDKEfl Ch« 
mjii!h3ne-laaEuAet rouClne into ■eiDOry. The progrflB portion can te uheiJ bb 
part ot Elthef bD Appltaoft or an lni4e«r prograa. 10 put Che 

■a t:hiar-ld nonage rouElDV Into newry each lime tho BASIC program l» run- 

le p» *■ " Wctt e™_-^ 

15 PHI NT -o«n cocc-fwaES- 

as PKim 0W> -DWN CDDC-PW^S- 
39 nUfI M- -MfilTE CODC-POfES- 
49 LJHEHlVBCS - TOW 

-« fm rutct - r6& JO 792 

COljMTfR - COUN-ra * J. 
1 

» IF cDupncfc c > 1 m« i2» 

W HUNT 

Ue UMENW«tft ' l-INENLIKff * 1 
1^0 PVIHT - POItE -jHJCE-"-". f^EK 

135 rPTMT 

a4B PRINT M^'CLf3St CDWE-fTWe*" 
IW EMC' 

WhED jDD uBI thl» prograa, eIle aUinbcr In line should be chBoged to 
ODntBlo iho line Tiunhet- of jout BASIC program trtiarE the FOKEiog progran 
portion IB 10 Blart. The FOB loop ift ilflE 5fl should contain fhE BtacEin^ 
and Ending decioul DEDHr}i Eocatlond of the machine- lac gua^r TDUtlDE you 
Ulah to cDnVdrt-. 

Once jCFu've typed in the Fco[iraB> BOHnlng it tflll create thn iBBt fll* 

CnitE-POHtS, HoM use EHe CDmand 
EXEC COPR -POKES 

to plflLE your BaChlnP-lafiRi'^BE-POHEinB program portion Into any oClier 
proRTDm, beglnnlnK aC the line Dumbar prevLouaLy apEclflEd- The program 
CODE-POKES VHItBH Hill WOZK vllh ElthEr ApplDSO^C or Integer BA^IC- 
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MAXFIlfS AND INTCGEfi BASIC PROGRAMS 



Art EKVXl ffle Huat be used If you uant tn Increase TUXFILFS FroP LfUl^e 
Intex^T BASIC fircfrom without erEBlng youf prograini Rer^'A biciWi Dse the 
ptncedureB deA^zrlbcd dboV« cr(SC4 en liXfO Eill^» l^t'q call It PlLt^tX- 

FlLE^Eir >h«jld cpfiCiln Che follwlng coHUTtdB to aIIw for 5 on a 

ay a Ecnf 

LOAD I'linCRAH 

The fJr^C line? the prfittron vould be a» laLIovs; iwtt that whet dpp^ats 
3B CTRL-D ±s crented by heldlne dcnm tlie key urked CTRL while typto^ tht' 
letter Dp 

J# PRINT "CTRL-D E]t£C FILE-EX" 
JV BEM MAIN PBOGEflM 

E)aC-UTIVE SESSrON 

The uaual ayntax Eor the ^X£C comnHnd 1b 
EXEC t 

where f is th« nUe Df A a«quentidl t<Tt fll^ [^enta inlitg BASIC ccnimandB or 
progtn UcftA- ^mnpl«« of thijf ufidg^ dpp«E)r chtouEhOut the earlier 
fiEdticDfi of this chepteTp EXHC with this ayntasL cAudefi the first field of 

f try b« rtdd Intct the Applt! If it w«re btiiie typf^d thd 

keyboard- When the first field's RKTUffP charACt^r i* ^'typdd", the Apple 
flttenptB to eu^ute the field'? cantenta as e BASIC QOKand, or eoter the 

fleld^'fi cc>ntcilt» as A BA^IC pr^jgrAft Unt* Th* t>^pe of BASIC (Integer or 

AppJe&caEt) fa nat changed by EXEC unlca^ the file ctnlEAlns an or TNT 

CHiivnd- Vhen eu^cutlon baa ceaaed on the firat fleld^ the aecend Efeld oE 

£lLe f l9 read Into the Apple and treated slml lur Ly* The action conea to a 

atop wheTt the Laat Field qf file f haa beea readi 

Th« I^X£C ccAnutid ^JnnoL be fitepped by CTU^-C- 

Ooly OMr EXEC fllft ud ba OPEN at any one Ctitt- If you Are EXRClnp 4 flle» 

And ona of tha ^nmnndfi thu^ executed is enother ElfEC cEnnmandp the first 

EXEC fild in lubGdLntaly CCO^td- Tharufter* It 1^ the iiacond EXEC 
fomnand that la being exeEJUted^ 

If a flla baing EXKCed {^ont^lna d cotnntand co HUH aoy progratn. EXEC wJll 

wait patiently until the progm ends- Than tha ne>Lt fiXfC fila conand 
vlll b« Aacuted- 
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mw#vrr» If n ptojtTam is RUNnlnR while an EXEC file Is DfEH, any TNFtlT 
■ tatwnt in thr prosTan will take Lhe n&Kt field In the file b^^lflg EXECcd 
Its rthponue, LenDrinn the Iceyboard- tfome yeti If that raspcrnae la jin 
liTwdlatE^^Eecut ion lU!? tCitoTnaod, the cCunniand will be executed before the 
prof(Ton r cnc Iniiir A ■ Etesulta cao be very cenfusln^- 

If you Intirrnipt a Rtfflnlns ApplesQft pTi>araB by typini CTHL^ while an 
EXEC file la OPEH, the T«fulnder of che £XEC file will uaually not be 
e»cuted. 

If rtrty field of an EXEC file canr^ot be Interpreted aa 4 vnlEi^ MSIC 
tntnnuind dr program l±naj the message 
SYWTAl EHROR 

lb generated^ and tha HXC (i^ld fa read Into the Apple- Thua, you can 
EfLEC any texc flla, Whelbet of oot it cootaioa BASIC atatenenta ffir^t 
be aure you^ve SAVEd any progran in nemory)^ In HON C, I, rrM>dOr thla 
CAn provide a crude hut hai^dy tdi^l lot quickly ejcamlning the cod Lenta of a 
teact filr- 

The EXEC E^oinuiDd CAn bIso be uaed with the Relatlven-f leld £Qpitlpn 
paraneterp in a Way that la « btt dlftCTWit Fran POSlTIQS'a nSe of that 
pjirfl^tcerp The ayntax for thlfl il4a Is 
KXEU f IpRpI 

Vhera Ep Speclfiea th^t file T is to he EXEC'd atartlng in the p-th field 
of file f- Since EXEC alvaya aeta the paa Jt Lpr-1n-the-^Cl le pointer to the 
Ilrat character of the file^ ao the p^^netar Rp Always tndicateji the p-th 
Field relativ* re? the file'a beBtrtnlna - Thus p always corttaponds to 
the flU^a Actual s or abnolute^ field- ladicdtas chat ExECin^ baglds 

with the tllft's fitAt field, HI lndt[:4itea EXECina befilnB with the seccmd 
field 1 etc> 

Mote that thLfl ia different frdm FOSITian'a uae of the R para»Eter, 
Inhere R3 ia a relict ive fl^ld Ofilyp and nay indicate different acrtual 
file fields at difteredC tlaes in a prograiD. 




EXEC HV?1LE, Rf 
gene rat ea ar 
>Jtl3 (JF DATA 

Deeeilgc if the K p«ramt«r Specifies the second field beyond the file's 
end^ IK th* jlrat field beyond the illa'^s end ia speclfiad, nothing 
hepped*)- 
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CHAPTER 




CCESS FILES 



KuLtlpLf XecurdH 
UlL^mpt Hkd lUDlai RuDdPB^ccua ?llu 






Pot 4 better underBtand^ng qf the iDlonnfltiQa pMSanted Ln chtfl chaptL^r, 
It is avEKeQtBd th*E yPU flrat read Chapter 6, □□ Siquentlal flEfS- 

RANDOM- ACCESS RLES: HOW 1HEY WORK 

KnnJihm-Jiet^L^aa He^t Iil<-i3 nre Il>e ^ colLectioTi i^f Equal-slEed cella In a 
honeycmb PME caII* »*V be full, ochers may bf enpty. E*ch "ceir^ Id 
EiBlll^d q recnrdp When you credtc * raDdoin-flCCeBa ftlEp ^nu iwat specify 
the EtBiuldrd ftlae fnt thft recorda th* file 1b tCP contain^ 

Unlike the fleldB in ftlhlUtntUI illes, which pay be cf aL^Dst any Icitgth^ 
the r^corda In a rdi^doflt-acc eas file are of a^eclfied fi^ed len&th ^ The 
Eiri^C time yon WHITE any particular record tn a file, epouflh apttce ±a 
Bcl flBlde oa the diskette fnr a tMipIeta^ BtaitdArd-leagth ir«Drd» whether 

not the record is actuflHy filled* &□ tandOP^-acceM fllea dort'^t 
nEceaaarlly represent an tfflcieat u&e of flpace- However^ filnce these 
file? are set up In HUCh a r^guUr E^^blDD, It'^S faat and raty to retrieve 
or modify InformatlOf* Emm any p»Tt nf the file — hentc the name 
" tatrd^^iu- ac c aaa ^ f il t * 

Random-acCftM filea should b« uaed in ap^^Llcat Inna re^julrlng fdBC acceaa 
tn varlool p*rt3 Df the Elle* or wheEf individual pieces d[ Inlormatlort In 
the £ile fleed to he t^hai^gfrd fairly ofceTy- For ejtflflipU> a randwfl-acceaa 
[il* in particularly flult^hle f&r malntalalag « mailing llat- 

Handom-acneeS filee are created Md retrievfcd lo a manner very aljallat to 
that used for a^qu^tldl fllea^ Tht Min differtnce ia that certala 
cCimbaTtd? have addici^al parametarJI OP^ requires an L ILength record) 
partneterp while REAC and HRITE t»ch use an R (Pecord niimb«} parameter. 
Some aanpJe programa will be preaented and dlBcuSfitd before getting into 
detallfl on cmatlng and retrieving randOTi-acceaa fllfifl and hov th* n^if 
parameters work- ftore technical Information about randcrm- JC c eaa text 
(lies luy be found In Appeildl)c 



A SnCinC RECOBD 

EoU can you hccebb a BpCCJfti^ recDid in a randim-lCCeBH fll«f The 
followlns pair of ApplflDfE pcoBtfliDB tlluBtratM hoB DOS allo-a jou to do 
ihlB. Ths first prDgran r&queBls a ntme (BE}, a teUphoQE nunber (PS^ and 
t zip codo Chen BEodB Lhen [□ recoid L ot b fU* CflLLfd H&ILER: 

t» ' CHR» '4*: PCP1 CnB-H* 
» IHRJf -;JP CODE. 

PRrHT pb* "c«k hftiLCR. lzbo" 

PRINT W P» PPlHT 2> 
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Ulii- ?0 plsrei 4 C1VL-D In Chtf VBriable DS, AH usual. 

Udpb Jtf tyirtiMgll 5* requtHt lha lnfor*Oll-in Id bE BEored^ 

Do TMt type any conua or CIDlons In your regpanBtb- 

tJnP hi l>l'EN» a fllE i!h11e<] HAILEH, vitt, ^l^-byic ions recordB. 

Lint Jt prapares for Tecardlnp I fl f o r>nfl[ Ion In record 1- 

Line 00 bciuJb FS and 7.^ to CtiE diBhEtte — aince rccc^rd T vue 

Apccllled In lEnfi 70. al] Ehref plDi^vB of infannatian 
irc recorded In rc[:Ei[d 1. aepardfed by RElURlU* 

Llnp 5fl CLOSES the 



With HON C, I, in affect:, vhen the program [b BUW you'll see: 

i439> »9-iaiB 
«SBS4 

Hecord 1 of Etifl Elle HAILEK CAn Iie E«trleved by this proeran: 
ill EEn PETfiiFXt HfllLCT 

se J*JPU» Hl*-n*.21* 



Uh«D Rim Vlth HUH C» I, a. you'll AVE thE EollowlnE. Ah uhujiI, the ^Ir 
Ot quEBtloa BsrliB IndtCBtva an INPUT ultti aors Ehsn ont rcaponiB* 

UPfcm iWILt^L-aw 
READ Hnil.E*,ffl 

And liBEe li A ■llghtl; dlffemt pED|in to ntttflva Tvcord 1 nf KULEB. 
114 ffEH PTETRIEW miLEff.H 
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«9 IMPUr Fl» 

tm mm c«* -close BnjLC*?' 



MUtnPU RECOfiDS 

The pToaran ihal crtBCvd fht randOffl-fl^cEBB (lie HAILER WTOCe Eo a alnsle 
recaid in the file, Baving ttir«e different pLecPB at IptaroBtloa BepBlaCCd 
by RETITRNe. Tlip aE*C progra* deBWPBCrates vrltlng lO t«ver»l CECoiidH: In 
pnrrLcLjlar, record numbpra 12 tticou^tt \5 of a tflndm-Hcciis tllc qallnd 

9# fw I - 12 TO as 
OR *mxr I 

UW PBIHT -COT* 

JSP f>PlHT I* 
Line 10 BEEB DS HQ CraL-D- 

Lines ?0 and 30 Hlif lurt U''7ILE Ib rwu file 

Line OPEFJB the file U-FILE. tatlDBC rer:DrdB ulll each bt 

3i bytes In lEogthi 
Llnu S0 Ehrod^h B0 create m loop EhaE VBITKb tbe informiEion 

NAHE ADDP£SS 

fnlloued by the record numfaeC, foc recorda li EtLrnu^li l5 
Sole lliBE jau ff>UHE apeclEy each recacd In ■ Eieu IffiXTE 
CQBBsnd> ^fore having PRITTT Send chlTdCEeca tn tbst 

re[:QEd ■ 

Lines 9t and 101 change rhn InforiDeCtH^n in record 13 ID the 

text ^Ivtn In Jlne Itfl's FBivr cnBmand- 
Llne 110 CLOSES the randon-afcue tile lA-FELE. 

If am c.l.a i» in cfFecc vtm cba pcogiu RDIIi pau'ii aee tb* 
follavingj 

^lf"-( r, M - ■ ■ f 

If t^H - r, f I- 1^' 

*• ! I f -'1 ' 1 1 J- i-'l 

1 1( 'I 'I I ir 



NftlH Pt4-J (LE was 
1 i '*;,t tf"'- r I! t 

Tn B alBlJac fashicrn. ynu can HEAD infonnatton fcom H selected reconJ or 
recnrda of a IfBC file. Tile next pra^rJIb COCrlBVEB recoFds 12 tttrouEJi 15 
□ f rh= file called FCA-FILE, trying, on line LO find which recordtdj 

CDCllllnB the UttecH "DOS" U the flraC Chra* chaEactera. 

3© fDK J - 13 TO 15 
5e INPUT #*< 

60 If^ LEFT* cn». J> - T-OS" THE« 

e& WJflT P«. "CL.OSF frn-FTLE" 
LtH :0 aetB up CTHL-D In 

Line 2* OPBRA the text file HA-FTLE, vhC4B recnnlH atc 3»-bytM 
Jong Ithat's ulieE Specified when the file van 
created in an «Arl1.vr progEan, reBeEnber?). 

Lines 30 through 79 BEAD records 1? thrmigh 15 of BA-PlLE. 

note that you PiU9t Specify each record In a neb READ 
CODmand, before a tub&equent IKPUT will read i^haracters 
from thfll iei:Lird. In line Cach record codwb in frnrn 

the disk ss an ASCII ACElng terminatad hy 4 PBTUBN- 
Llne 60 checkH the 3 leftmcst characters ot Ehe INPUT 
String A$ fcctD record e, eo see if tKe word "ixis" 1b 
Ehere. If it is, Eha neBftflfte "^ECOBQ r HAS CHANGED-" 
is printed and the aearch conilnueii 

Mne 8ff closea Che iilT. 

Heri'a Bfaac you'll atn uhen you BUH the progrsn, IF W* C, 1, ±b in 
efficc: 

OPEN ifB"f JLE. t,-" = 
W«E flOMfCES IS 



as 



Nfldcc tli*r vhtfi the file wad retrieved nnly records th*t bad been wrJtten 
Co werE Bxaalned- If yci\^ had aeVBcC for record S In RA-F1LK» you Wauld 
liave rccrlVfd 
SNU or UATA 

ktBHElEr. Bluet ttu inforafltion had btto written thdt record of tht file- 

Stinll^rlyi had you ttlcd to ItiPUT more than one field frwti any nf the 
exlBtlDK feCOCdft you would have bern ftlven the ^snH n^SSAge: eacih of 
rtcbrda 11 tbrpu^h contdii^e only one fields 



A DWONSTRATION : THE RANDOM PftOORAM 

Ueat but by no nieanfi l«DffC, the Systf^m HASter diskette cOfitfllUH a ^Tdgrdm 
Called RAHDOH C^flt e randoiD-acteHa text file to demonBtrite A anall 

Inventory control Otlie»e- And by Small we menn amall: the proEran can 
handle at hCiSL 9 pflrta- This keep? the proErsm ^Inple* Th* Apple^ of 
courae, !■ ctpalile of bandling thouaanda of psrta In ao liW«ilEory- 

Flrst tho prUE^^ copfes Itflftlf »nd the rdndcw-flcceaa te^t file APPLE 
PRDHS need to Iteep trflcfc of the lovti^cory, then It au t onia 1 1 cal Ly flUNa the 
prngtflra for ycm- Vou can Hat one or all item* In che inventory- ¥au can 
alflO ch^Ttg^ Itetna, either on* 3t i ti»e or all flt oncie. Here'a how it 
vorha^ R^iDaiober to press the RETUUa Itey each tlH you complete a 
reapouH^- 

1] Ftqid the SyatEm Hasc^r^ 
HUN RANDOM 

dUd you Bhould see the BeuBAEa 

IHi^ E>£^Vh^Ih^]lun IdlLL NOT E^iTCAJTt: OH 

VOU» RT>S SVSTFW 

FWF VOUB CWVERlOce. P*OTVl5I0l*S HW£ 

nfWt TO Ce*^ T«l£ PKKR«1 WD IT^S 
DRTA TO RHDl^ER DI^TTE- 



W> VOU WSH TO THTS NC»** I* 

l£ ycu type Ti for "m" In r»pan» to tha «bove uA&aK*^ 
you'll find youraelf ttcfc In Applesoft - 

2) Frud T FOK ^^yu", Tou'Il aee chn bUftaK^ 

mow vcwiMQ iwtn 

7Qlloved by the measaKe 

3) TLa^crv^ the Syaten Master dldkatte^ and place a 
tiQri-wrEte-protected diakeLte in the drlve^ thea p»ae 
the KETIFRir kay^ 'fou'^ll perbapp c^tch a gl-i^a ot 
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ttv'n ii-Ri. iv(e#»kH nw iwnfi Hnvc HCCN 

rilLV TPHWWtlrtltt^^ W r^f^TrfMW HILL 

and th«n the progm will bagin aHcutlon* 
4| Hnw yeu should ace Cblat 



LI5T I 

treaa 1 and ynu ahould aee thia me^a^E^- 

5) traam 0^ to get a llat All "p^rta'' la Lhla "Inventoc? 
eyaCaai*^ and you'll 

^fiGT4 SI^X Ih STOCK 



1 


P«a«.LCL PUIKT 








ComUNimTlEKS 












e 


4 




2U 


e 


S 


01 5K BOOT 








STHTF HnCHINF 


21K 


4eB 


r 






STfl 


& 


SERIAL P«IHT0f2: 




741 


9 









fWtSS WE Rglt*** TO CDHTIWJt 

When :^ou*Te ready to return to the list of options, pre«e 
th^ KEtUfUf key* 

b) Try out the varloua prosram optloo^F Choit^t 1 flllowa yoo 
tCi liat parta by part nunbet, ouC aL a tlnei AS wall aa 
all at oucgp 

Choice 2 allovB you to change any Qt all part nanea and 
deacrlptlnna d Por exaiiq]le, finppoAe pATt 3 ahould lie 
nand COSHIC GLUE, sl^e 56, With 123b In Stock- Here'a 
hov to rcvlae the entry for part 3: 

select optlQTi 7, CHAMGE 
select part nuDber i 

th4 old pan ndiut Ifr displayed, with the cursor at ltd 
Atarti to nllaw you to enter the nev Tiaine; when you 
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pTiJBp Che aE;TUAT4 kQ]^ tbe cursor vill move to tbie rif^ht 

and perft^m slhiHArly for p^tr ai^c and qudntltr 

to thA EiurrenLly dfEtiog nane or aize or quantity 

Choice i vill atop the proRrQEi. 



WRm-MG AND READ-MG RANDOM-ACCESS lIXT FIL£S 

Uhcn uEEd vlth randon-acc«Sl Filr^, the CL0S3 comiHTid Hork.a exaQtly he it 
dOfefl With Sequential files (^e "aPF^Hlng And CLQ^EIng StqufenCldl FilM"^ in 
Chapter 6)' Hc>v«ver, che nyntdK Fcr DPEff an Addltlt^sl parawtCTp th« 

L pfiraneteT* which la requtred ^ 

flPEN f ,LJ [,5h1 t.DdJ [,VvJ 

The "L" atanda for "Leoftth-of -rtcord*' : tfip nutabrt J lodicate* ho^f nuny 
bytaa (charACCars and dlgitA) are to be allotted to each record in tho 
randQci-accea& file you^re creaClnft (or^ if ycru're retrtevlns a Ell** the 
nuBber that were slldttcd vhan tha fllv vds cr^dctd). IE cha L cpclan Is 
QBlttedri J Is dssigned thfc default value tiC 1« Thd i^ifidier J mat be li3 
Lhe tacge 3 th^nu^ 




When yc>u OPES ■ file prior to READlna ^ if y^u specify a different T^nRth 
parameter^ than you Jpfrclfied wbEn you DF^Hcd prior to WBITEina the 
file^ D0£ will blindly uac Ehc n€W Lec^gth parameter to calculate record 
poattlona w^chlf) the file. You vill hava to ^eep detailed vritten 
documentation on the Btrutturo and CDOtenta of your files iaonie 
progrdinnierb keep auch lnfQr«tf4>n if\ TACOTd o£ the file)- It's halpEul 
to always include the Length pSHlUter ln AAtb file's name . With froch 
naroes a a 

STOCKL1ST5-LI0B 
UIKECTORIEE (L5t> 

There Ib t^o Way to find the length c£ a record in a randofe-ecceu filei 

you niuat tnalte thift t nf o mkat ion part of your ioc ufWfl t a t L ftn - 

Hecorda aluauld never be longar than the number of tytefl opacified by tha L 
parADieEer; r^fPCdfr nay be partially ove r^ vrl 1 1 an or comblnod with 
confuting resultftp 

WHITE and REAb ench hav^ an R paraEoeteCp to bE used uliEn creating or 
retrieving particular records In random-acceas fi|.£a. 

WRITE f |,»r] 
RUD t ^RrJ 

ExJlTupCes: tftLlTf LEGIBLY, R.^^ 



as 



The Hr (Record] pnraHter Is to create {with WRITE) or retrieve 

(with ItRAJl) the rth record of the £il*, iTie default value of r ia 
a;4LifyLnA the fitat record of d file* 



LFainit CITRK: ^{i atop a R£M> In Appleickft cauaes a atrtn^ of KEEHT£Ba CO b* 
Rtn^rfttod^ press the RE9BT key idatud. 

lr\ fiCirie reapectijp edc^h Separate record In a Tai>d4nk-ac:taa9 teiC file may be 
treated as a short ac^^u«nclal file. VRITE ^nd KEAD CBd bc uaed with a 
lyte parameter in addition to th&Jr R paraneter. The Byte paraneter 
api'cifiiiE the hEHinn^ng byte Of the specified record^ for the next PRTNT 

(4irttr WB1TE> or IHPUT or CET (after ilEAD>- 

t^iTE f ;,Rrl |,HbJ 
RtAD f [,Rt] I.Bb] 

If Bpecified» ,tha B C^te> paraneter cauacB URITElciE <or REAUIng) to 
hejln at Che b-th byte of Che specified redord* Tlie default value of h ia 
0r the Elrac byte of e record* Hie B paraneter may specify a poaltlon in 
the record either before or nfter the current poaltton-ln-the-f ilt 
polnt^TF UaiD£ the B parowter necaultatee a thorough^ detailed^ 
hyte-^by-tyte hndirledEe of the contenti of eeth record in the file- 
Once FlEAD or WlTTE has moved the poBic Inn-lo-th^-f ile pointer to a 
piircicular record^ PCr^JTIOtd can alac? be used to iDove the pointer ahesd 
EonCy) further relative-field positlona vithln tiie record- HowevCTi 
P0S1TI0E4 cancelB ta.thtr WRITE or HEAD niode [without chsngioK the 
poBitloo-ln-the-fllc pointerlp bo another URITP or TtEiU5 connand <thlB tlua 
with no pdrajDeterl is nece^s^ry to r^lnJiCBte that Aiodep 

Details Cn ho^ iofDrvatiPTh Ib Stored oa the diakette in ^eceral^ and in 
r4Jid«]-acteBB files la particular* may be found In AppendiK C- 
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IF 



CHAniBt 



ACHINE LANGUAGE 
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DOS alliwa yflii lo store DTI diqfceiiE, and rtCtiEVp EroH dlalvtU, tba 
iBfomtlOn In your Apple JT'a nKniDry. Vou hflve HlnadT Mt^ Elw DOS 
cOBKaiida SAVE. LOAD And Biffl: thu« ccnundfl dut with tin conEnU Ot 
Apple V ptdgzrBB amry, intKpnEAd « cDHntfa tn BASIC proflnW. The 
ME doiBvndi didcuBctd in KM* cbaptar ~ BUTE. SUUD imd BitDV — Hrfan 

■lldlK fHUCLDH, but EtHT? JmI irlA ClW G«lt«ltl «f p«tlc» Of 

■ mawity,. In le< mlqtflTpnHd, nw b£uEV-wd-|wudw:lH]. fofn. 

Hw ■ lieEon each of Ch? EolLovlns comdndB atndS foT'ft BilkUT fire; ^ 
B Mlmo pVKBdae the noinp t.f binary files in th« CaOJM. A Mnacy flli^ !■. 
just AD euct, Mt-for-blT '.-upy of the InforaatlaD thgt vu BEoced In d 
HperJfled TBiiHe of Apple meiiiDry locallcma. Those loCAtlMI iffy luva 
contained a mac hlne- 1 .mfci: age progr«rn, bloBCy data. Of A blC-<lappVd 
"plccuie" tcom ^ple'a tiigh-rflaDlution graphics BcrHen> 



BSAVE 

i«tMt of mmtj* thm Ayaux 1ft 
BUn ( IJ ^S4] I.Ddl 

irinn u u««l tli* A, nd V p*mii«t«» stukd for ll^t inid>«p 

^tlOOAl* 

Ih* A pBrauectr bpecifles the jt^rting AddrcBfl <lii eitii^r deciaal or 
bnwUcliAal codtt of ch« Hmory pprticn to b* itor*!! oa dJ-qkett^^ A 
dollar AlB^ ( $ 1 ut pi»4«dfr n nldruA o^imJ Ia fcaadHlHl* IE 
tiu A pATflMUt !■ 1*H tlMltt n A«t« ClUll USU* A 

±» dUpL^adf Thanfor*, *^Tid«t hb^Iva *ddn««u mf hqE 
b* U4d vlth thl« ccuMftuilf Vithlit th* TAfigfi # thvouKli ^5935^ u «Tor 
■Htag* ^ iBWAEtd if the A pArABBter BpeclCIe* « flCArtlua Huorr 
addnn tftu dou not cur^pond to actuals Installed meaory chlpo^ In 
pTACtl^^p It ii not UB^ful to Bpectfy An A paraHter greater than the 
]UxiBtiia TMOOry addrEsa In ycpur Apple (49151 or SBPF? on a ASK ^ysten]). 

The L par3Qet«t fipecifiaa the ^en^th. 111 byt«&, of the meniDry portion Co 
he atDTe-l- IE the L jiorametec is lesB Chan or greater than 6553^, a 

uaaage Jb gsneiated. If the L pAramBtflr is 9 or in the EBnae 
Cheougih »^35. a 

RAAGB EBUOR 

mmmg* !■ a«auiktfld> 32767 la ch* ^lutUE tmntte la hftma that can ba 
atnad la a ■ln^la fUld on Eha dUkatt*. If jva wlih to non Ure thu 

32M7 HHTT Iboatloda, uh tvo BSATb. WthlB the range I through 32767, 
fM 'rror meeBte* 1b 0«B«T«C*d 1£ Kiw L perantcer aptclflaa a range of 
BOKiry Oddreaaea, net all Hlllck GorraBpond to actual, lnatalled BemoTj 
dllp- Id practice* It ll BOt Vnfvl to apacLfy a raoge of meHory 
AddruMB ntandlai b«Toq4 tib* Aln wmncy addxu* m row Appl« (Ul9i 
or «UTi n ■ UK ITBW) - 
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] N^' H >:j^cTip U h i .11 ll ("rt'.i to .-1 file namert PICTUTIE L"<fnL j Inln^ jn I m l^-.l ( Ke 
ttUL^und hli^hTeaolutlcin graphics of the Apple's mesory^ They are 

«p#rHl4uIl:r IdHtluIk but tlMlT itartlflB addrus nd I«ith ps^uMnB 

BSAVE PICTlllt£^ Al&3d4. L&7tHia 
BSAVE FIGnmi, A^iff^ UlU 



BLOAD 

L'll^' BLOAJ> coBniAnd return^ the cof^ tents ^^f -h H [ n.ii'y I i tti y^iLir App 1^ 1 L 's 

[±9iHry- hLOAB does not eiAS^ a BASIC pro^rAn In nenory, unl*ftB th* data 

BLOADpd Into th« pmrticuln portion ot hktj coatAlftlAg jwr prosraa* 

The ^ynt^T ±h 

BUUD r 1^1 [^Sa] |,Dd] E,Vv] 

vlun tba 8* AAd U pAtAHtera ah bs U cIw & piffiMimw* 1* 

utedf tbm tlH liMty E±1«'b confcsiti npl«« « portion' of tbt nUtiiit . 
MAbHt* of Jq^l4'# m m^ rf t lugldnliig ac ltddnt* t- If ihU'A. pumow i4 
iLDt uad| ttaa fltara coAtnta At* ntanud to th* mmmm AivIa hhuj 
loCAtloDA vhDU cootHt* Hn Drl|inAllT BSAnd* 5a* BSAVE for a «apl«t* 
dlKUAtlH of KiM A p«HiHrCor-, 

A^Euru: tKn- binary f lU- PTTTITI^I! contalu A tal|lL*H»ltlClD4 plctUTA* El^Mr 
ct thGse c]^aTnples places the picture ttWO thm ftt^t kf S;h«^040lotloa 
graphics area ot che A|>pli^'^ Denary: 
BLOAD PICTURE, AAi92 
BLOAD PICTURE, A$2<01< 

Bittm eVi^l? fll^ clofabera the EAH veraiDn a£ Appleaofta 
fc»* i * AichlH-^lAiiSiHI* ptogm no longot W n«itt*bl* 

If It £b BDWd to ■ nABDTT lOCAtiOtt dtUOHlLC tb*a ChA 

«■ fm itilch it vna *A.TAd* 



BRUN 

TLt^ qync^x of the BRUtI command 1$ the «■< *fl COT BLCUDt 

BfeUN t I.AaJ l,S*J l,DdJ L.VvJ 

The Binary file £ should be a nBchiTie'I^nguage pTOgrAiiL* 

First BKUH doeq A BU)AD» If Che A puoiHor i« Klvfn, the flla'p qontevta 
*n'pl*tAd Idto Appln'* .n«Dty bAflimlDi at location ** ti tha A 
pAtAHbtof 1# *ot uudy Iho fil«'t rantonU *fa vetofiWd t^.tb* Aaw Apple 
mtmtj locations nbona conCnta ma orlgiuUr ISATEd* Baa BSAn for a 
cHplot* dlteti««lH of Hw A pH4J«*t«r^ 

After BlXSALln^ Ebo fUo^ UDM «0«a * «h*ChlH InguAt* JoHp <JHP) [4 
|4>c ntlon A* If Eh* flla ana a kAddna-lApffiaBO ptogm^ thla bosiu 
execution of Chat profran* 
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THE RWTS SUBROUTINE 



NonallTf UHr 4CC«4» to dod El^o* tlu DISK ll 1b reetriczted to th« u* of 
DOS* Bcnnv«r* uuClwr mthoi o£ ac«HlAg tht PISK II la avall^M* 
HchiH Uitftiriii* pn^Hvn- Ten mklp ebl* ««tl« If /oa'^ra not 

Thf r)TSP n can be dCC+B^Bd directly from machine l.inyu;ii;c throu^ Cht UH 
PI 1"Ck' RWTS subroutine* uhlch 15 part of the I]OS. The "kWTS" Btliuta tox 
"htvid L>r Write a Tratfc and Sector"^ In tfcit follovioft ^upldndtlonp any 
r^^'^r-^ pru'ceeded by & are hexadecimal nutnberfl* 

Pvtrv dliskette InlClaLlEfld bj the CISK 11 drivft ia A^iiT4Hd into 35 
tracks, rmmh^red 9 to 3*, t1ia« tntdca asy GlKiudat of m flrooHt on a 

BaBicalJ-y, th4 trukA uo ftrnn|»d In B^untA MwtMtiic clrel*a^ idth 
tha h4l« in tba c«t« of tht ^*)L*ct* foxBtng Cb« canun center nf 

tlrt d.rcl*n» Tr*ck 1« ob chn «it« e^ge of tb« diskette^ track ^4 

la IW«nvt Eh* C«dE«r< Tha diafc drive d "head'' th^t lots very Euch 

likm oH^la ad S ncnd plnyar, except that the head oa the dlBfc drlvp 
la BMUtte* Tbla Itaad nove* Co different tracks on the diatetta^ where 
It olthar rud4 lnfonitl» rff o£ thm dlakeEtA, or vrlut Infoniclon 
onto tha ^ab«tca* 

R^di trr^cV on the dlskatte conBiat^ of 16 aectora* S act on *n ^a^^tafliud 
arc«n>;ngb on each Cracky that allm tha tisar to work vlth c4 
2^6 bytes, rath«r than with th^ antlra 4096 h^tca th«t f£G On ODa 
The Sectors vlthln A track ara Indlvlduallr nunbered, eania«ttmy, § to 
15 around tha dlakette* Aa tha diskette aplna^ Mch lector irill odea 
undanuAth tl« bud, M lAlfih tlw tlw head writ* to or read from that 
■Htor* Badi MCtor dond^t^ of tvo poTtlonar the address tield and the 
J*t* field- Tbo addrao field contalna infonnation conceminf^ which track 
Cha h»d £* on^ which sector £a obtttt to ^pLn p^i*t the he.^d ^ .and the 
VOlUH V^«T of th* dlakette- Tha d^M field contains en encrypted for* 
of tht Actual 25fi bytM of data which were stored on rhn: i-ector* 

The "Read or '^-rltc a Track «Fld Sector" subrontln- irn^tpned to as the BHTS 
SubroutineJ^ n]^L^-^ the user tf? wrltr Information LOp or read Infonutlon 
r rom, finv tr-ick ar.J SH?r^r i^r ^^n the riiakett*^ Vlfi nuchlne language* In 4rd« 
r^■ ii^.L- PWT^ ^^=b^L^u t ine J thi-- n^s^r must flr*t cradte an lOB 

lInput/OLEtp"t control Elect) table, and u acCD^axi^lng '^^Lca 
Charact«rl4tl0fi Table". The JffA teUa tl» XVIS nbrouttitt uliicli elot ud 
>^;^ve nuDiher the dlak drive will b4 lA, Mcb. voluum Whcr to axpact nn 
th* dlakett^^ which tr^ck «n4 04ctoT to 4ccua» and whather to read froa 
0t yrlH to thn dtak^tto^ The lieviee ChMHctarUtl^e Tdble providea ao« 
Intomatlon to tha RVfS Auhrdutlne that la necessary to operate the AppU 
^ISS II- 

To U«e the RWTS subroutine* tile uhbt iDust set up tile lOB and the Device 
Churact tristlcs Table Bomewhere irt nemory- A ''controlling Subroutine" net 

written and stored In oemorji The subrtujtlne must JSR to the stdrtloft 
addrua of the RUTS aubn^utlne (at location When the BtfTS 

Bubrouttnfl 14 Ju^d to, A <od t WE UAtalit Che «ddr« of 

tha at^rdiv location of the U»* The A nglatav met contal* (be bigb 
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fddrepa hyte^ and th? Y regiBt^r the 1m eddveu hyta* Tb* fonat of the 
«^ (DB la ftlvea Iti t^hle 3| ei tha and qI thla aactioa* Tabl« 4 glvea tba 

Coraat oE tha Dnica Cbaracterlatlce Teble^ 



if 



lE-j »iTt- ih j^n t'T^Bmple of how to uso chc^ T!UTS iiubroutlnv.* The eimple Hffl* 
tlf-v1^^ (^harar teriatlcs Tables, and a CL>ntrolllne nbroutlne VEll all he 

^ Iciiid^tl Jim> rr^Aory Just After location SCflS* 

I The following caDtrolIlDg aubfoutlne vill load the A and Y reglaters with 

f ~ I ^ the 4dd»sa of the atartlnft location of tbe. IOB» and Ihen Jump to tha BVTS 

I etibreotlAe- 

^ I ^ #C IDA la^C Load A raftiatat alth SVC 

I $Cfl2- Ad 0A LDT ISl>A Load T HBlatat iPlch HA- 

^ ] Z3 $Cfl4- 20 D9 0^ JSR 9^309 Jump to the tUTS ai^utiH 

^ I ^ SCAN fi» KM 

- rln- Ir^lloving lOB is one that you would ute to dcC-_-SS slot 6, drive 1, tO 

^ write 33yc^a of nKinory atartins at location 92000, onto crack IB* 
vactOT 6 of the dlskattaj 





i\ 


PuTDoaa 

tOB typv l4dtut«« oust ha 901 


8C«B 




Slot Mi^ar tlaaa 16 






Diak drive nu^r 


SCB) 


H 


Expected voLuaa nualiar 


SCflE 


IJ 








Sector number 


gcia 


2J 


Low-nrd^T hytt- of Device Characteristlcfl Tfibla 


sell 




High-order byte of Davlca Characteristic? Table 


SCI? 




LHjw^i^rder brta of data buffer etei^tlnfl addraaa 


gcii 




High'ordar bjta of data bntfaf etDft£n| nddveu 






Unused 






UnuAed 


SC16 


0? 


ConnMTid code, $^ • *tlte 


SCi7 




Error Coda 




N 


Abtnal velw nunibev 


9C19. 




Frayloua alot mnbar accaa«ad 






Fref lew drive nnbH e^ceeBed 



The following Device Chirac teristlc£ Tabl<^ nu'ic hn^ JcirlLcrfedj we'll pl^ee 

It at location SC28. Just after the lOB* Locations- SClfl dnd SCLl in tlia 

lOB above point to the oddreafi of the Device (,hardL terlstlcs Table's 
Starting locatloii* 



Location 


Code 




9C29 


49 


Device type cod? (pui a $94 ttttm} 




$1 


Oi^abtt of phfltti per ciack (put ■ 4ft liAra) 


Sciz 


BF 


TIh cfnat {pat d h««i) 


SC23 


DR 


Tlw count (par r SDB bare) 
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then 

^| r 

Ai.r LW/; 

w] I L L'.ua^^' t lu- t'nC L re rouLlne to execut*- 



TABLE it FORHAT OF lOS 



1 



IBSLOT 



la^ 9b[0uld be a 341^ Ho bthar type dodea a» 
CurrMtly defined^ 

HuSE contain the numbeT of the Blot times Ib^ 
In which the di&k drive'^s contToller card i& 
located^ For eumpleh II ycnu vdrtt to At^M^ 
slot f6t Eh« valu* must be stored in this 
locatlDQi 



IBDKVH Mtiat c^tatn the lumber (rf the diafc drive to be 
acceded — either $01 or StfZ« 

IfiYOL Tha mxLuH nusAtar of tha dlakatta to ba 

4«UH*d UNt b« _«o»4 Voiwe ^$ mil 

■atcfa cha vclun Twober aiplgned to mj 
dfaMtta* 



USBCT 



^ H^ar of the track It to 34) to be 
acntwd ia atorad bara- -Holt ba withLii cfa* 

me nuB^er o( the ?ectof <| to IS) to ba 
accad^dd ±4 Btorad hara^ ' Mlat ba vltbia tha 
ranfta ^tfi to 



irtfl IDICIF Thua two bjCa* wwt uotain tha addraaa ol tha 

aCutlAS loeatlon of tb* Pmce character iatica 
Mbla {«« btlo^^ ijFta 7 net coTic^in tha 
Ivitr^tin b^te of tht ad^ra»s» and byte 8 wat 
cOllUla the hlRh-orct^-f byCn^- 

THLfcSt crontaln the address of the 

atartlTiE Location of the "data buffer"- TtiC 
data tvffc^r is □ 256-bytJ_' Img aection of 

■e&ory upon vhich tha AWt£ aiibi^Hitln« will 
pHtata^ II. rou Pta wrlclns «te tba diakaBtat 
tba taCnHClon Id Eba data^ btif far irf.Il ba 
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1' 



^tjttdu onto the diskette^ It you ara raadln^ 
frfhin the dlsl^tttp th# inf oraatloii tb^t ce^w 
o£f o£ the dlHk. will be stored In nwmory Gb* 
location of tha data buffar^ 156 bytaa la bftth 
tba ^"i^— and tha MiHiMi uo^t of iufon-^ 
atlon. that can ba raad Or vrlttaa by tha HfTS 
aulwutlua^ 

tl&il2 Unttaad 

13 IBCMD Trt clil^ byte la stored the command code thAt 

t€lls the RUTS subroutine exactly what to dO^ 
Th4 i^aluef that cau be atored In byta H ara] 
$01 — Null coiiiBand+ Doea Tiotbilug but St^rt 

tha di«k drive aad position the head- 
4fl — Read the entire Z56 bytee stored on the 

dlakatta dt the ap«clfl*d track ud aactoTp 

and atora thaa In ■BHoty at tha locatUm of 

tba dAU bvffar- 
WZ ^ Vrlta tha HXt 2M bytaa atotad In 

at tha icculon of tba data traftar on 

ta the diskette at tbe opacified track aad 

ftactot . 

— ?onnat the diskette- Uhen a dlaketta Is 
formatted, self ^synchronl zing nibbles sr^ 
vritten on every track and SOcCOr on the 
diskette^ Becauaa all of tha diskette is 
fOTSattedp the valuea In bytes 5 and 6 ara 
ignnrad« All of a formatted dlakette la 
avallabla for use; tbere ±b no DOB^ 
ftnytbinB Ho»d on tba dlakacta mtll tba 

14 twm ma loealltni vtll contain t9iA coda no^ar ttrt 

mj «nov that ba aticoustarad durinB 
execution* Xf tb* IFTS Subroutine retuma 'with 
the catry flag claar^^ tw error h^a occurred^ 
If It retutiv ifltb tba carry flag aet» tbla 
b;pte indlcat^a vbat typa of arror baa occvfrtd- 
tif — l>lBkette Is writ4r*^r4tantad| and unoot 

be bitten c^^ 
$2§ — VoluBa uisoatch errors The vnlune 
ntmbar of the dlakatta found was di££erant 
than tha voluna apacLfied In te 4* 
84tf — Dr±H artof^ Sonatbint Unuaual la 

~- IhJ mm* TbaiUns nutlAa waa^ aftar 
n ntMatad attaBpta^ hnMbla co-»Ad eltbar 
tba addrasa flald ot tha data Eiald^ ' If th« 

data fi^ld for tba specified sector has 
n^ver had anything written on it. th^ti a 
read error vlLl reault » because there l£ 
n >Clnnjr ^,1 r<-5d- 

13 l&SKOD The voluEna numher of the diskette that Is 

actually found vlll b« acorvd in tbl« Ln«Uioni 



TABUH 3; PDRHAT OF l^h [ C:4aclTlued ] 



16 [OBPSP Thl# bjte miiSt cmtalri the aLot number tirasB lb 

Qf thf slot thAt vd4 acce^s^d Av^t r^centJy- 
Vpt If you prevlouBly accBBBed a disk 

drive In slot fltare the valua $5tf here. If 

there Is cc CDDttdll^r in th» Specified QloCp 
th« djBk vlll tiangp 

17 tOBmK Thifl b^te nuHt ccntaln tbe au^ar of Chi dtflk 

drive thJIt lUfl aci^ea^ nAt recAoCly — A S>1 



Tribi« 4] fdhhat of pcvict; cHAitAcrrai stick xaUhE 



Byte# NoH FnrpoJe 
1 DBVtPC Device type code, telUng what type of ddVltA 

this 1b- a $00 Bhauld be stetDd In chit byte 
for use with « I^ISJC Tl^ 



Z PFTC A Bhould be AtDtfed h«r«P 

3&4 HORTG HPtor en tine ccuat cDnplEioented p In 100 

vlcrc-aecond interVeld^ K S£f »hMld iTI 
byte ADd a ^Dfl In byte 4p for use vlth a 
DISK II 



9t 



, AND CHAINING 



m S«t««tla« I/e DcMuAi IM, nbf, toll Othte Binfr 



nucime i/o oivms: h#.m#«id oiHOt nuv 

There nr* vartouB vays Id which IqfonutLon C4n be U9«d aj input or outpu 
for ycur Apple copiputeT^ Very o£t« thfi keyboard serves as a source ol 
InpiiC* UbuaLIp the Appl« UHt c XV scmn for wcpvt^ but any accessor; 
or par£pb*r4l cMM^CUt to * contmtln la me df tbf -tmn Apple 
ACcusorr caa-bs used for Input ot ontpnc nlng thm Ifff ud FB# 



m cibtHliiB subsequent input frc^ the device ci^ntrolled fron 
ftlot tbw Hate! if slot r& cantaina a dlak contrDlIer 
card, thl4 CCTMiDand will cause DOS tc be booted^ If nn 
devl(-f- Is In slot the syi^teoi may "hana"* Pr^es the 

RESET key to recover - 

IirP obtains subsequent input from the keyboard (not alot §9)i 
ln^tefid ct ■ ^riph«ra] d^ice- 

PU 1 transfers output to thd d«vlce controlled froni slot tl^ 
usiAtly the ptint^r* Note; It o? device controller 
card Is lutall«d 1q aIai fl^ thA ayflCani "hAA^" 
nd TOtf'll hav« td prAU tta* KBfSST kaiy U HCav«^ 

FSf $ ntunv output Co Clrt TT sctcn (Ht to slot M>. 



■ * 



The 4ynGU for tb« rniMinili in 

« 

PHI B 

vhere A apeclfln the slot Ch> Nj^e. Uhat bapp«u dtpnds on at 

14M tlwB $ STRUX EBECa 

i n-<«tftblidLa* usual dtfvlca (for IXi^ Input fron 

tha kf^nnd^ for output to ch* TV jtnu) 

I throve^ 7 crAur«a to dnlee conttolUd from «pA:l£I«r| 

flint fbodta DOS iE u (Tlrt controller card I* In 

8 through IS SYNTAX tRKOR in def arrad-ga^CuLiOr^ fcoda : 

the system hama in IsDadlatfr^ancuClon soda 

L7 through 65535 EASGE KRKQR 

grucar than BnUK BUmt 



The etiMand n# n-«atiAlttfw* Inpvt Cvoii the k^rboKdi FRl I 
ra-4atAbliabfta outpuc to Eh4 W acruit* 

Vlth DOB iA «Cf«ct> the IHf and ml rfiMamla ba UB«d In Iwdl^ta 
anAtiftton Kde in tb* usual way (aH your US1C vainiala>* But ufasn they 



ar^ lasuad by IItma Tn a proftrn^ INi nd P1# mmt Uk* tha Corn at DOS 

H-HiTHMndfl Furh An 
l» ii? - khU (TRL-D 

/tt 11^; "PKff 1" 

3tt NkINT DS; "IK* 

V]tcn DOS ie^ not^ in effect* the LUl and FKif comutnds set the contents ot 
th* Jtesle Monitor Input and Oatput ragl^tan to a«|Kt tim daalrtd Input 
and uutput davlcu. 

Ulten DOS IM In uffactt Cha coptanta of tha Apple Monitor Input and 
Output reaistars ar* Ht G4 Ml«ct DOS, iifill4 tb« eonC«ut4 trt tl» 
Input nd Output re^itn Ht to 4«l«ct the dealf Bd lApvC And o^Epvt 
device^' Ttw Ibllowliii paragraph* describe vtaet heppana uch tlae a 
tharatC4t leave* or antara tba ^pla* 

Wfit-Ti Che ^Ift Muds n output chaTactar^ the Jpple Hunltw Output 
register directs that eharactar to DOS- If tha character la to ba aaut «n 
(beenae it la not part of a DOB cwund)* DOB dcaa faat twn^taga 

Hitch I 

Id First* DOS raplacaa th« czoTitentb of the Apple Honitor 
Input acid Output raglatars i^ich the cc^c^ti^tits che DOS 
It^Ut and Output treflaterp* Then it seuda the character 
Hit W the device m selected by the tonteota of the 
1^1* HnlUt Iqmt and Output reflatera^ 

3. Vartf DOB ru^^Odnecta Itself hy ^^^irv pl^clns the 

pointers to MS In the Appl^ Input and Output raglatara* 

Similarly^ each tiae the Apple est* (or an Input cherecter, the Apple 
Hanitor Input register directs that request to the DOS^ Once aaa'i^i ^ 
doea itit f^st ti«o-stAga awltch: 

1. Firsts DOS raplacaa the contents of the App)e MonltciT 
Input and Output regiatera vlth the contenta of the DOS 
Input and Output regiatets. Then it obtaina inpuC 
character frn tha device now selected by th^ Apple 
ttmltor Input aod Output rejln^H- 

2- rtaatth DOS r«-co»ect9 lUelf by a^ala pladlAg tha 

poloters to DOS Iv tba ^pla Input aod Output ragisten^ 

Hhau DOS Is in effect, DOS Intercepts all Input chAracter? from the InpuC 
device before they reach Applct^oft or Integer BASIC or the Honltor- That 
iM Vtay IR| And FRf» i^en typed on the keyboard AS imadld t a-axacu E iou 
euBaanda* can be trapped and uead by DOS tu chan^ the t^S Input ud 
Output rafliatara* 

SLTTin.irly, [>C\5 Intercepts all output characters frum the Apple befon tfaa^ 
roecti the output device (but after they have affected the A^le Honltot 
EnpLjt 4nd Output rsftlstara)^ lliat ia vhy IHf aod Vtf^ it Issued fm 
vlCh|Q a proKfsa but nut in nuVTed Wffi cHunda^ can diaconnect DOS by 
dumglAt Ch« Applv HuultOf Input and Output reglitars belon the cmandt 
ever gat td DOS* Dacauaa the aatira contents of tha Ibnltor Input 



and Output regtBter? Are repliced uch time DOE Attemptfi BEnd or 
cecelve A chATdcCeiTt DOS ylJl lUuAlly n-coanect It^^lf If It uaa nDt 
dl^cDniiected 4t hoth Input Afld Output «e^^^^^^ BlBultanEnualjp 

If you exBcute a PRf c^mnand froia wlthtn a pTOHTairij vlth a pTOHraai line 
9 uch aa 
50 PR? 1 

then DOS vlll partially dlacDnncELed and unablE to intErcept subsequGilt 
Dutputk DOS EtllL cQnnEctEd for Input, aad ths next at^^pt to obtBin 
BRf Input chaT(ict^r vllj, cauQE DOB to rE'Cocmect ItEalf Ivt bolh Input and 
OUCpilt * 

TliB a^H situation nccurB vlth the uaE of Ull Idflldl pr^smn vfa«n DOS Is 
[fi effect F A pTfrgrn lint sucti 
bf 1141 1 

dlscfrnnact DOS fox JVubBftquent Input- MS la atlll connectsd for 
Output^ And tht next dtLcnpt. to fidmL out a charBcE«r IcVCn A r#Lurn OF J 
prcHTi^^t charncrtit) vlil cdua« DOS ten r^^connect Itaalf for both laput acd 
output ■ To avoid such confllcta and allov DOS to nanage tht Input Utid 
OutpnC rE^lateTS, Iesue and IN# commaTids In Itnmedlftte-executiQU moJe^ 

or fla W5 cmimindB Lrt progrflm Ilftea auc^ as thoee mentlDued Earlier: 
it DS - CTRL-D 
21 PRINT D5: "VM I" 
30 PRIHT D5; "JTIff Z" 

The CTdL-D charActar t4ll« IMS thAt the follovlnt output c;haracitErB are a 
DOS comDHod k 
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TAMhK Is APPLP HONll'OE INPUT AUD OmrUT SEEIBTERS 



MonlUir Input ltf>£liiter! Locatlrms 36-37 f}:}S-S39) 



When Register 
cactenta 
rtrt net by 

[Note 2] 

B CntL-K INote IJ 
tNfft [Nate 2^ 

I vhere b>^ J 



To tht 
value 

-Jftl 
(&F151H) 



4913? -k a*7SS 



DOS boot 



Then Buhaequen^ iriput 
coQWB Etm 

Hoqitor Input Routine 
fr«i Applft keyboard 



Slot is 

It slot tfs ctiittaina disk 
coatroll4rp th^A boot. DOS 



*B574 top oe tKbp 
(-azl7E + STop Qf MfiO 



DOS 



Honltcr Output Regt*ter[ Ldc^CIdv (S:)fi-537) 



Hhen Ke^later 
coFitentR 
are aet by 



To the 

value 



Th#n aub£tyju«nt output 
floea to 



RESa -SIB 
cm-P [Note L] t9FD7((> 
PR#i( [Note 2 J 



R CTilL-f llflcte I] 
VRh [Note 2] 

[ vhere flH J 



fl9l^2 + 8*256 



t1anit<»r Output Routine 
to TV flcreen 



Slot H 

It iilat Is Contains dioh 
controller, t^en boot DOS 



DOS boot 



-I- Top CpE tnumw 
<-S2l42 -F $Tcp of KmO 



DOS 



Note I* Th« t^tenda « CtHL-K and s CTKL-P are HotiEtor conmndQ- To 

type CTEIL'K (which doea not appear on the TV acreen), type K vhile 
holding dawn the CTEiL kEy> 

Htitu ?> tflitn DDI^ La m effect, this coAAiand w]]] afl^tt the citnit^nte of 
the Apple Monltipr T^Later Qfily if th« comtnind is ldSut?d ab an IndtrudtiDU 
In n «tori!d ptogtdnL and not in a FHINT CTHL^Ea In^Cructlon- 

Tlote Iti addition to the cmuDds pentioned in Table Ip directly 

PUirF-J~tnQ appropriate vnluea into the ^pTe Monitor re^later locatidna CAn 
aluo be u4ed to Aelet^t Idpiit Atid Output deVicBa, or to re-t^otai^Eit a 
disconnected I^OS^ 
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ubU It DOB umn Aro ddifvt Udsme 



input Bafliater 



When Register 
contents 
arc sec by 

DOS boot 
RESET 

IIJll [Note 4] 



iHls (Note 4] 
FRIHT DS;"INPb" 
iHote 3] 
[ iribQf * *>* ] 



to the 
value 

-741 



491 S2 + MZlft 



Thdi^ mubmtqu«nt input 
coat* tron 

HDQltor Iiiput EU^utlDe 
£tm Apple 1t4;ybou4 



Slot Ib 

If slot l£ COHUlU « 

disk controim. tbu 



MS Outnue lwlJt« 



mrm. JtC by 

DOS boot 

PRflO [Note £i] 
PRINT D^;"PK^&" 



PRfls [Note 
PRIHT D5i"PRi'H" 
iHnjte 5] 
[ where B>i } 



to th* 
CSrort) 



(fC4M> 



Hcnltot OnCpoC Bq4C1u 



Slot fls 

disk controlltir thi 
reboot DOS 
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Kotm 4« Whan IH)S la In effet^t, thlQ czDHand will npt affect the 
CHt«ntA ffC thm DOS lupvt mnd Output rftgl*t«r# it tb^ coiiuad it li«ued «■ 
Alt itinimcEloh Up jl «t<pr«d i^ngrim wl nat to. « puhv ctKt^ ttmnctioA* 
tf « prairv line dath 

ma 

!■ ««UC«di th* contents of ttie A&pl^ Monitor CHitpUt reftlftt^r will bt 
c-hAHRcd^ 1i>dv|ng Dr]g pE^rddlly d Is connected until ch< wnt input- 
Hot h- r III 1 h L R cou&and y it la asauDed Liiat the atrlng*^ar labia Tiamed 

Iiv4.-[h dttsl^ned the character control-l>r or CTRL4. This character* 
vhLcb dc«# 4ppur 04 tbv «at4m* is pr^^bicAd by f^rP^B ^ ttbll* 
holdlni doHa tlu CTBL iwj* 

Vott 4p No BAttu irtut input or output _dnlu la ■■Iftctad by tlia DOS 
Input and Output n^jt«i^ in^t ub «1» Im nulnd CtM th« diik ud 
04<pt»t cu b« Hnt to ctaa dtik^ 

K^te In Ad^tli^n to the coHi^ndA In TdUe II, dirfictl^ foeeiuk tbe 
Appropriate value a into the DOS Input and Output register locations CAU 
Alio be uStd CO select irtput and output devices- However^ the apecific 
meinory locatlona of the DOS Input and Output registers chAitgn? wftN 
rELfferent Bystem owmory sist^s And witli differ^t VL>r^.[L^^^^ T>r^^. F^r 
lliiq r^asoHt a spec la I procedure eKiats Eor changing; ^ f^it l'[ t o r^f th* 

[>{JS Taipitt ^nd Oijtpi^t regiacer locationa. It la a Lvo Bt^^p procedure : 

a) Change the Apple Monitor Input and Output regx4^tt^r 
locutions to the vaLuea you wiah the DOS Input and 
0iitpi4 nSt^tUft to contain^ (ThiA my ba don* by 
dinctly PODlug tba Apple Houltot raglsttr locations 
or «»«tLtl^ tMt 40tl it^etfnttlona in n 
vtond proirniu-) 

b) CALL lii2 ffron the Honltor» jou would type Smfl)^ 

After this CALl-^ DOS will be re-connected vJa Che Apple 
Monitor registers, and the previous convenes of clia App[e 
HofilLor Input and Output registera will appear in thE DOS 
Input and Output regl&ter locations^ This CALL c&n also 
be uaed to re-connect D0& any tiui^ yOur progTAB BHds 
to dlaconnect DOS for awhile^ See the p^o^^.^HpAg^ 
J^l for an euinplc usin^ this techni^u*^ 

Sot« Si Tfa« Uonitor coHudn n CIHLHl or ■ GIRL-^ * vfm typud on ch* 
l^ffbOftEd, ATA not ncopiitsd by DDSt CIht affKt tb« Af^l* HnitOt Inpvt 
or Output n|t«t«» dtnctlr* 



rHTEGER BASIC CHAIN 



£:fr|:aln spplicatioiu ^re moat faally Inp 1 tH d C tni by bfliilK d Series d two 
<fr HT* frnKrau which are LQADed and KUN sequeotlAl ly . In fluch 
C: 1 rcUHtenc eti I the second prograa often rte^dB to UM Eh4 Vdlu^fl C»f 
V4Tllble« and arrdyfl develctped by the flrat pT^BT^m^ Thr Utbll BUh 
CiHTIHnd trASCJ the fltSZ pTDgram's ^'arlables and arrays when It load? th« 
^efDHi] pTQf-ran. In Int«:£«r BASIC Ibut n^t Appltfloft) the DDE cDnmaDd 
CHAIN allovB you to load and mn ft flecond prOBrflfii wJth&ut etaelDg the 
first prap^ar^'B var^abLcB dnd arr4yi' 

5u[ipD9e you've been using an Inteaer EASTC pro^ru C4ll«d MRT OBE* The 
cOnjujInd 

CHA^h f-AHT TUC5 

Will load and run the Cnteg^r BASIC progrsp called PAHT TWO irltTiout 

clearing tTie values of any variables usetT in the pro^^^™ PAJ^T 014 E- The 

CHAlH COinErTA[>iJ [Tlaji b« ]a@Lied In JTOmdi Ate-ClKfuci^n kcdt dt shown dbovep ur 
Iram vltttii] tba last l]nea af Lbe PUT DME ptn^raq a DOS cnn^nd^ 

2Wlfi l}S-""l REK CTRL-E 

2002? PEIHT DSi "CHAIN PART jm" 

Tbe Syntax for the ccmnaEuI tulllarl 
CHAIN f [pEfl) [,Dd| [.Wl 

APPLESOR CHAIN 

The CHAIN romnund v^rhf^ ^nly v| [|i integer BASIC^ but if you du rut need to 
pASa Vdrlabi^Hp It ie aasy to link Applesoft pr^ftrflfrtS to l4ad and run In 
sequence. In the first pr^grani, ]uet include ^ l^^t line 4bCh SS 
!999tl PPIBT CHR5f4}E "RUN PART TUO" 

^en thia linE> fs ejcBcutedp it will atart up the second program (where the 
second progrsn is named PART TVO>i In the process^ the firat prcgran and 
nil Ita vaTL4bl«4 are cr«fted- 



A difCerent procedure uiuat be Lised in order to load and run a aertee o£ 
Applcfii?ft pro^rarEkfi wltheuF er^aln; trarll^r valuta of vdrl^blos and arrays- 
Td chain in Applesoftp you will need to use th$ uchlne'-lvnAut^C pr0fLr4m 

ctlJed CHAIIJ Ehot ]s on tlie DOS Systeei Halter dl^Vette- 

To chain from a program called PART ONE to a pro^rsni called PAAT TVO, you 

mubt have the tHAIh pr^grdiD iin th4 BSM diskette with thtf progrtP PART TVO 
Isec next page EoT InSt ruCt lon? 1 - Then» elmply [naert these tvo lines as 
the IsSt EVei Itnefl tea be executed in the PART ONE progran: 
am PRIKT CFBS(^); "BLOAD CRAllTp AJ?t" 
?aeift CALL 53fl"PART TWD" 

Th^ two Unea any uae any l£ne nunberap but they ahould oome One after the 

other in th« progrdni, dS Jnditdtfd- The first Tine losds tht ApplcsoEt 
chaininft ability Into the cOaputer- The Second llvia actually dde? the 
chaining (but ase next page, fnr warning]- 
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Thsr* miAt h* HP spa» In the third Elne httv«#n the CALL addreqa i2i 

Had thi! folloUiitg Erqorattan Aterk- The CALL addreoq must not be ;sEvcrn In 
handed nsl » 

T£ you have Applesoft on the flnnwAre KClH Cdrd, you can copy thr flHAlH 
program onto another disteCte by using the FIH pttpgrsni. (AppendlK J) 

If yoi] are using 0^ Applesoft (on diskette]* you can copy thE CHAIN 
program onto another diatoCte using FID (Appendlk Jl or aR follows* Flcst 
place the CHAIN prOBtdoi Into Applets rwhoryk With the cDDimand 
BLQAD CHAIN » AC 2^6 

Then *dVe it on the desired diskette, with the COmnand 
HEAVE CHAIB, AlJISfip Lt5fi 

Note that neither Addreee psrowt^r for copying CHAIN Id th« bau as the 
Addrcaa parsseter (ct sctuaLJy using CHA^n. 
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tjoat nOS L-OmBflnda r&fi^r to a naiDed file. A file may be a tMt (dAU) 
f Jl«, ciT a progTdTD In Integei: SASlCt APPLESOFT or HAclllne LnHUAg** Ttu 
t4r>I« below indicate vMch flit t^pu pif b« uisd by ucb «w4d. Tlie 
ftr«t Ubl* llsta the cwiHiids: ^|A4b«ti«lly ) Cbtf flvccmd tAb^ t^Mpa 
tbn by U40ciaH4l Cllft trp«- Tb« rnMindi GAUtOC^ tHT^ HUmES, 
WMi Kwrat, PM 4Ad iVf ar« not IncliwIM bwuiu thky do oat uplldtly 



HL£ TYPE USE, LISTED BY DOS COMMAND 





Integer 


Appl«Boft 


Sequential. 


Rmidoii 




rn—iiMd 


MSIC 


uatc: 


ACctH 








?roBru 


ProgTMl 


T«C 


Text 


B£ut7 




F±I* 










Amn> 
Bum 






X 






BSAVE 










K 

X 


CHATK 


X 










[:lose 














X 


X 


K 




X 


FKFt 






It 






ENLT 


■ 










LOAD 


E 


X 








U>CE 


% 






X 


It 


QP1« 






E 






posmcai 






E 












X 


1 




VEUME 


1 


* 


X 


E 


X 


nm 


X 


E 










E 


X 










X 


K 


X 


X 


X 




X 


E 


E 


X 




KITE 






X 


E 





NqCc : iL-n: (Ktfte coMLanda only Sn defer led eiiEcutl<ni HO^: 
APPEJID, OPm^ FOEITiaH, RFM, URITE. 



MO 



Bin 



gequentiJl Tejit fil^ft Only 
APPEND 

FDSlTIOa 



Etcher SMiditt^ T«t= >^ Tt - Ml1in in'- «" Tfttt "t. 

CLOSE 

RE&D 

HRITE 



Machine LflHttuw fll— onl* 



All Tvosa of FH.gg 

nELETE 

LOCK 

UMLOCK 



Will, POSttlWl, KEU, HUTE 



tfhen DUS cl*ft*Cta eItI frmr ccnncctcd With dlf^V LFB^ge^ It noriaally diBpley^ 
41 iHHflriK4 dtscflblna cbc error and ttop& any prnnran that ±b ninniAB- 
Thetic mBsageB ate In addltlcn to the uBudl tnCSSa^t^^ generated by 
AppleBQft or Inteaer BASIC^ DOS Deetiofe^ Can be disriUKUf xhed trm thnsf 
gE ApplEooft DT Intcget BASIC M fotic^u?: 

All ApploAoft HBQage, such ad 

ts prorede4 hy ngu^^tlon OATk- 

An Integer USIC oieaBage, Buch as 
*** SVtlTAK ERB 

ia ptBC^dfrd by thrae ABtsrltta- 

A DOg nesM^e^ such as 
SYNTAX EXRCHl 

preceded by tio character at all- 

A DOS neEsage appears exactly the whether yOii STfl In AppleaOfCp 

Integer ftASIC ot chti Kcpc^icar ftt the tiM ibr meqaage la generBLtd- 

If a PDS TTiepsBHe Dccura vhen ytiu AFC UBlnp the Mnoltar, thm system in 
reaet to the type oi BASIC frflm which you enteCtd the Honltor* 

lly usEitg Appleaoft'a DNERE GOTO conimflnd Isfle the Applesoft m^TluADt yo" 
can creste Applesoft iFrror-hand IIbk routine* chdt cfeal with DD5 mcapnaaa 
which would normally Incorrupt your progrdiD. UJien a DOS ecrcrr occurs 
following an OHERl^ CTTO comflnd in an AppitiSdEt progranip a code Rubber for 
the type o£ #^rr&r Is atored in decinfll SMory location 2??- Th±a Is the 
aoiH neiDory loC4Clor in which AppUeott stores the code for an Applesoft 
error mesaagt- The ^cpm^nd 

aeta the value ot Y Co tbe ApplBaolE nSERR GOTO cod« cprreapondlng to the 
ercoT that caused dn Applesoft 0NERJ1 GOTO JuBp tP occur- 

DOS meafidges dnd their correspondlnpi ApplsaoEt OnERK MTO code& nr& shown 
helow, with (be iBOat common csLiEe o( iftch Maaafie* Eich df tha oieaaagrtf 
i4 than dlscuaaed in grcQcar detnUj with a Hce comprehenBlve ll*t of 
c^uaaa and cures. 

OWRR OOIO CODES 



code 


POS itiesaaftB 


Host conbcm CAUse 


L 


LAK^L^AGE NOT AVAILABLE 


ApplEsolE. nOC on diskette 




IIA14GE ERRCR 


Conmand p^rametet tbO iBTge 




WRITE FKOTECTED 


Url te-protect tab on dlakettB 


5 


EHD OF DATA 


READing beyond end of E«Xt file 


S 


FILE WOT roURD 


File miaJpeJled t or not on diakette 


1 


VOLLFME HIEHATCa 


Wrong Volone paraDsteC 
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nNt:NI1 GOTO 







Hoat councn caui4r 


u 

V 


T EQUl^D 

J J u ^KpLrpi 


Door opefip OT diakfette not InlTed 


Q 

r 


III SpIt FULL 


Too Dan; illea ort diHhette 


Id 


Fit E ] JirKFTl 


AC CCHpt to Dvt rewrite a LUCKed t lie 


IL 


ifmA% RHJEOR 


B4d f 11a name p paraBster » COUdI 


ii 


HO BUFFERS AVMUELE 


Ton Bany text files OViS 


13 


KtI.E TYPE HSSHATCa 


DlsketLfe Clle doesn't outch comwtnd 


U 


PRUCfLAH TOO LAHCE 


IflBUf f Icient Apple qemory flval Idbla 


15 


NQT DIRECT CDAUBS 


Conapd mu^t be Lit 4 pr^^grAni 



DISCUSSION 

LANGlTACa «DT AVAILAflLF jONtRB GOTO code - 1> 

Olcuts if &05 cannot find a prtPBCanmiins lanfiua^Cp either Tntcgcr BASIC ot 
Applesoft, that 1q required to execute a DOR command- CoumLands FPp 

lirr> W^J> and R\m may all Initiate A langu^ga search^ If Integer EASfG 1q 
r^^ikicjci^d, DOS look.B for Chat language in ROH« If Apple9<>Et iB rtqutati<d, 
DOS flr^E lodka Eor the laTi^uAHs In BOHp uBlng Applesoft fron ao Applaaoft 
flrware BOH card (if available) reaarJUss ct the card's iVltcTi 
position- If Appltfroft la not found In SOH* ftJS lookfl On the dlakette In 
the "default" disk drive — the drlv<= Indicated by the default or most 
recent vaiuCI^ of the 5 and D paranwcerj- DOS will not look on any other 
dlBk drlve- 

Thla HAeage usually atlEea after a DOS TC'jLi^at for diskette AppEeaoE^^ If 
th^H diskette In tbe dtfault drive does not cOntsiit the proRraiii APrLESOFT, 
Replace the diskette with one that contalna the progtan APPLESOFT^ or use 
the D piraneter with any DOS comrBsndp to aeLecc the Another drive. A 
^Otafnand auch as this Will do nlce[y: 
FP, 02 

1* yoD cblnk DOS Bhould have found Integer flABIC in ROM, but It dldn'Ci 
try the followlngi 

1- T^iTfi off your Apple and ranoVe the cover* 

2* Locate Ehe rcrw of four large RQH chips ttlack, raccaagulaF 

CfhJCcts> In tht Diddle of the Tnairt prlnt«d-clrcult bosrd* Theve 
chips are labeled "Km F8'\ "ROW F(", "ROH fiB" and "ROM E^''^ 

3- ETdsb dovn flrtniy On these chips- 

4- Rt^pUce the cwer^ turn on the AppJe and try INT again* 

If yoLA think DOS ahObid have found Applesoft on your firmware EiOH Card^ 
but it dldil'tp try th* folicvlnEi 

1- Tn_rn aif your Apple and remove the CCVOT- 

2w ITaplug the Applesoft firmware ROM tard* Locate the rov ot 
flv* large RDH chlpS (blacky rectangular objacts) acroBS the 
cardp These chips ate labeled 1^ 2, 3, 4, 3nd i AbcrvE 
tbe chips, and PC. Oe, Efl, Efl and F> belcrw tba thlpa, 

3- Press thea« chips finDly into rhelr sockets. 

Plufi the AppUstift card back Into sUl the lettMHt slot- 

5w Replace the cover^ Cum on the Apple and try FF again^ 
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USGE EHROB (CfflERa GOTO cC»d« • ? or 3> 

Ot-i^hirn whon the valu<^ of a DOS cOHUfld paTAVtet or A 1^ CrtHbH^^B^^^ 
iia*d vlth q^Lch pAruatsi*- 





PorPTTU-rflr 


Letter 


KInliDUB 


Hnirlaiim 


All FlleBl 


Slot 




1 
I 


/ 


Sequent Idl 

TphE Files: 


Byte * 
■relative FlBld fi 

flbBolut* (EJtEC) B 


I 


3^767 


M,LiiiL.ii"-AiT esf 
Ti.K[ lea: 


SfCOrd Length 
KCiH^fl Murabec 


L 
P 


t 


32 767 

^2767 


ElDflEy Fllu: 


Starting AddKSa 
VuBbvF D( Irtfli 


A 
L 


9 

i 


65535 
3Z767 








Range 


HaKlmuiii 




a 


9 

% 


16 

16 *■ 




MAHILES n 


II 


1 




nAna nitfw iRtri^U ^ottolj^ lulu to <t4iflMt» 



** HaKliTTUB slot nunber buU* IMP <)p " 1* ^ dflf«rAd- 

execLition diode only. tbA SSnU IWUi ^IWWS* 1* given fM a valuM 

tlot«; Th* DSft of T*lueH outBld* the ranafla does cmt always c-ui^e the 

RANGE EEAOK HsaAie^ Any DOS cmKmd pdrafiM*r or cpmiiHiul quantity that 
ii less tbaQ a ox greatifr tW 63535 vllt tha S^EVTAX ERb» aaaaaBV* 

not th« BASGE BBRDl. aaau^a* 



WRTTF: PROTECTPU (ONERR GOTO Cc^Hf = ^- ^ 

Of^CuT^ wtien DOS attemptB to stor* In f QTma L i on ao 4 diskette, but the diet 

dTiva dw nm^Mct m ^VciW^rfttMt'' wtcb or cutout, on^th* laft 

of tha o*t*r B^*^ Ac f ■« rt* Mt ItMy fMaai 

1+ There an adh#il*^ lab«t placed over che rl ■ ■At^tte'^B write-prnrect 
dutauti to prflvfint atilildtatAlLy nVM-writ I oz deleting ^ny informal, icpn 
OA tha dipkettQ^ TM» L^^. t* ramovtdj wheraupod DOS will SAVE or 

2> Thar* i» Bft m?lt»^i>t«t cutOM oo th* dlakatte* t>it* ±« tru* « tl™ 
EyataH Maftcr dlok^tta* Cor bb]c1p4p pntoctloa* HbllB lut rac4nnend«d^ it 
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I H ^h^^HN^|^l f to earef ullf cut a notch of aiLact ly the <?orrH?L^[ .^[ ^h- -mrl in 
HKjpHllv ! Kr (orrect places 1la« ailOthar diakette'B urite-prnie^ti ii^Uch tot 
4h ttH mU' I ' 

J, LI ynu reci^ive this Tnenaane "hllf RUNntng the COPY prDBTam* and the 
CAtia^ la not i L ^lt I or 2 y above ^ yoia riLiy h^vf in^artad tba diakette lute 
the drlv* ^Tlt^^^^ec Liy (in any oLher aJt^i^tl^n, tJ|}S fttvaa tha I/O ERROR 
uaaagQ to Blgnal incorrect dlaktttt* ICLsartlonl^ (}iect- tbe diaketta's 
poaltloa lA tiM drivcp^ nd te-icad Ch^mr I** dlacuaalnn on In^vrt^lnR 
dlpkctte*- 



y.m OK DATA iOHPKfi GOTO code - 51 

^Hiurs when you rry to reitltVi.- Information from a porLlon of a tewt file 
wKh'I L" no L rt f ^iriaat IOd hai ever been stored- Any byte beyond the lASt £i4ld 
I n .1 MH-quf nt I5 1 tci^t File p or beyond the last fEtld o£ tach roc&rd iti A 
I .Luiknb-'.ji ^-L-ts tc^Lt file^ may contain the valu^ 0. £ero Is the ASCII COda 
liT .1 iuitl character^ a ^Vothin^", and any CoAnAnd DuC the 
Ti^tT]^^vat of this character resaltfl In thft BHD Ot DATA uao^ge* R«wber 
that only OPEK autcnat i cal 1 y Aata tha poaitloA^i^-^e-^lle pqlnter back to 
tb« -file's baglnnlng* Tha waBaEe v^ually occtir# aft« u 1NPDT 6r a <XT 
coHwndi and can arlaa In Aaveral different vays: 

Iw Tod many successive INPUTS Ot JNFUT with t^o m.iny v-ir L .aSl l-^ . FhS^Ii 
TNPtJr or ISPUT variable cauaes one additional^ .i d J t-i 1 1 fat^d bfj- road 
E nto the App le * 

2n Too many BUQceaalve GET a - Each CfcT ttads; one additlonaLp adjacent hyte 
or character Into ttxa Appla* 

3^ Tha B (For Byta) parameter wa^ toe large* Ln a«quBntial Elles, tlita 
|wmit«r mat not apecify a byte beyond the laat RBTllRB cbatruur m tbe 
fll«- In r^ndpn-qcceaa f]J.e«» the B paranatar ahould nut ap«cl£)r-* 
liigrcpWr thft iMt Rmroi chaTMC«r in tba curr«tl? abetted ne|>^; 
knluiaJ^ Chft l^iK 1»u 4 t^m^t 4 v^cwd u Ion* 

4* The B (for Ralatlve-Eleld poBltlori> p-irnneter in a POSTtlOW command va4 
too larger In aequentlaL flits, this parameter oiuBt not apeclfy a field 
bayond the laat eKiating field In the ^Lle- In randot^acce&a files, 
position's K parawtar ahould not flpKify a field beyvnd th« lut axlatdJia 
f laid In th« cumntly selected ncort* 

Hemnher, the R parawCap iwBd with POSITION is not the same as the H 
paranettr ^sad vlth t^AlN It apecifies a field poaitlon tri the Iil-e» 
fgl^tlva to tha cutruC fd-lfr voqltlcm and torwacd in the file, only* 
WflpKlElaa nn chWM clw wnU fU^^popUlW^ MM file 

1^a«ltlon ahead to tha |£nt^ b^ta £dtlatff n^ tba Eifll^ diat^ c«iiC»liia the 
rucrent position^ 

POSTTIOB Bcans forward through tilt contaata of the file, byte by byte^ 
|D^](ln^ for cTit^ Pp-th T^ETURU character. If It etit^unters a 9 byte Ithe 
null character ) before f Indlng the refli] 1 red RRTURW character ^ the EMD OF 
DATA Bessage ia given Inswdiataly ] It Is not neceaaary actually tc lUFOT 
or GET the null ohacactar^ 
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lArMC^ Thl* piTSMter may Bpitclfr thE f±rsc Eleld beyond the lilt 
CUfiBLLilK lleJd in a lllc, hut attemptlnB to apficlfy the second field 
bpyond the I±le-9 end will cduJ* the ENEl OF DATA ^^b^rb^ R^cnbcr, 
ajH-c^EI** tbe firat fl^ld In a file* 

6. Th^ H JToT Record) parameter in n KE/iD coMand apeclElvd a randou-dcce?a 
flW record In «lllcTi nnthlnfi has yet been BtCircd^ Before ycu COn READ 
from a particular record In ft randon-acCCfl^ f[lep yOu rWSt flrat WTT& 
itimP Informatiun Into that record* 

Rcmt-Bt^rp READ'S B paranettlT Ja nat the tAH fla the H parameter ubcd ty 
POSITION or EXEC* REAC'b R paruuter specifiefl abflolytf record In 
file; M la the Elle'a fltat record, Md do on^ 

DOS US" the OPCH copinand't L pftraneter for calculflclnj^ wtiero the *T-th 
record bftftln** ao th* 0?EK preceding BEjUJ muat u» the aame L pmrBBetet 
Valiifl as the OPEN that prcttded WRITE for th^t file. 



FILE WOT FDUKD fON&BH GOTO code - 6) 

Occurs >flien certain DOS conmandfl ftptclFy a fil* ttame that is net In the 
CtfALffi for the dlafcetie In thfi Sel*Cted or dtffauLt dlflh driw- Only the 
COHianda SAVE, BSAVEp TWIT and OFE^J Cfln credtfr a File OicSr rtflne did not 
pr«iVt0U3ly exist- In addlcEc^O tp theit, CldEE oiay bP oaed with nny valid 
DdlW^ A tllo n™ flpficKled hy any ftth*r DOS coraBand oust alte&dy exlat on 
the dlaVstte^ 

Thla EKHSase may ariae In varloua mjMl I- You may have nilBdpened the 
file's ndnbi by a typing error or by emitting tht comna that sej^erateB the 
(lie name from a lollCiWlM paranet^r- Check ch# CATALOG tut thf enact 
btielllnfl of the flle'^ name- Wamlni^; If ycu have accldflntsHy typed 
control characters Into the nan of A Flier "TALDCl vlLl rtdt display cheJic 
charactara^ For help, sea "^lle Nanies" In Appendllt 

2, The File is on mother diskette- Check thfl CATALHC, 

3* The (li* hM been acciJcntfllLy DELETtd- Check the CATALOG- 

4> Iften ytm uJe the IHIT CDmnflnd Dn a dlsVeLte^ you specify P fils nd[H 
irbfch DDE thereafter dtieinaca to Hill* MCb time yfiu hooL the nyaCfPi with thoC 
diipkette In dl*k drive 1, Unleaa you write a BASIC prt^ftram, and auv^ It 
Utilna the DAK Riven to IM[T, the FlL^ MOT FOtTHD [nea^aae will ht given each 
tlK the *yiCe?i iB booted with that diskette In drW* I- If y«i cen t 
renpf^er the name of thla "gTcetlnR progrfln"* you must ra-nlHlT the disb, 
or run MASTEB CREATE to rensrw the i^recting proEram u| chout deatrDying the 
contents of the dlskt'tte. 

VOLUME HIEHATCH [OKERR GOTO code - 7) 

Occura the ToluiW fVf pariPwter used In a DOS crjmTTi*Ftd Is not the sami- 

as the volume rturnher aBalB'i*^ to the dlflltetta In the default dr selected 
dl^k drive, uhen that diafcttte vb4 TNTTlaLlzed, The volui* number □! n 
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diAbtte la ihovu at the head cf »ch CATALOG dltplayp Unleaa a I>D& 
eCAHftil Jlpvrllfea a particular voluDe ^ the d J akettc Vuluw number Is 
lAttori^di dnd no neiSa^ lA gln/Enp If a DOS ccpm^nd ape^lfie^ VOIuttv? P. the 

dlahette^a voluue nuMsc-r is still Ignored* If no volume nuafaer [h given 
with ITtIT, ur II volume number | la R[ven» the diskette VlLt be Initialized 
vltlh the d^fmilt VOluTne numbtr 234* 

1/0 1:MU>R (Oma COTO code - 

Oc^nirP 4fCcr an unSuccefiAEul attempt to atore date On a diskette or to 
refTt«V« dAC& fron a diahette (DOS trltl 96 tlincBp then ^Ives idpj - This 
■KBfllV can occur In the falloviog wa^a; 

]k The ael«ctcd or delault dflve^a door la open- Close the door to the 
dJah drlvf- 

2. Ko diskette In the a^lected or defdult dlak drive. Put a diskette into 
the drive and close the drive door- 

3- Diskette In the select^ or default dJsk drive has nut heeu 
IHlTlallted- IWfT the diskette. 

4. Dlakctte la inaerted Incorrectly- Theck the diskette, and re-read tha 
aettlad in Chapter I on Inaertift^ dl^kcccce* 

5^ During execution of 4 Vp^IFV CQrrnand, DOS found the specified fUe waq 
not Btcred correctly on th* diskette- IF the fll^^S Information 1b atHl 
In vfflory, try £turlue it sRain (perhaps on e different dl^kette}^ 

6f The DOS command'a D (Drlv«} pdr^foetet hdS Specified a dlak drive that 
dQ«s not «Kist 1u thle system. The default drive la nou th^ non-evlstmt 
drlv«« Just specify the correct D paraaeter with the next DOS coainqnd to 
reset the default* 

7m The ayatep la trying to acc^sa a I 3-iectcr diskette uslo^ Ifi-aecEor DDS- 
U^e the NTFFIH progr^Tn tP update your duk^tte to 16-sectctra- 

B« The D05 (Dmnsnd^S S f^toc) pjfdmeter has specified a alot th^t doeJl not 
contain a disk controller eird in thla Syetem. 

Vpu are In tFouble^ but cai^ Still sav« yoursttlf; don't dcapalrr The 
problem Is thdt the default slot 14 riov the upty slot your IsBt DOS 
comand specified- The next HOS COHUnd Vlthout A ^lot peraneter vlll ro 
to the enpty slot dnd return thft san Hsoage sb befe^re- To reset th^ a^ot 
correct lyp 

4} Presa RESET 

b) If you see a Honltor proapt t^) p type ^Dffn 
c} Type CATALOG Sa where « la the c^rr^Ct llot^ 



DT±iK FULL (QM^l GOTO rod^ ^ 9} 



Octurn Utv^n DOS atLc^tA tu store Infann^Elon an A dlsk^^tctp and finds that 
no mote stDraRe apace is jvalLnbE^ Cril thsL didkEtCe^ A BBBCmum 
flL'cton f^dn be^Ti (firj^ii VLE.1i user-stored InF^nutlgnri U diapisyed la the 
CATALDf! (if Art Individual EiLe ejtcE^adfl 75^ VdctOtA^ the CATALOG displ^iy nf 
Uji l4n^Eh BCartft ever asalji at BBft) .. Lf you roci^iva tha DISK FULL 

M^fll^aBe^ ir»t aAdurad that all fl[fl4 ar4 CLOfitd, and that DOS aave^ Eor 
yoM til It cotild (l(!mng you with sou portion of jflur file floc on the 
d1ftk«Ett)p If ycm receive thla wasflBe whll* fltfvlrtg i file called STUPF^ 
ch« Eir«t Cthlrtg you should do la (0 

nam 3tu?f 

and Cllffa san ymir pragtrtn on another diakette thqt h^a ktc IcIe- 



if you receive Che DISK FULL Tnesaa^a qnd then 1 mfw did Lt 1 y try to SAVEr 
HSAVE or (fillTE any fila on Che dlslc^tte before ^ELKTEing Sny fllefl, then 
(are yuu ceadyT) the aector Jen|Eth of Eht cm* t>f the E^nttJeA flhotm In the 

CATALOG vlLL be set to g1. non't deipAlr: dt^ffplte the odd appearance a£ 
tttut crttry's CATALCG display, the file Itself la [In^ thapc^F to aVoId 
such situations^ IF ypu j|«t a DISK FULL i^saag«, DELETE acne fHea before 
t rying to save other F±leB» 



FILE LCCXED {DHFBH GOTO »de - 

Occurs when you try to SAVEp BSAVE, HKITE or DELEIZ ualng a fila navia that 

hap bean LUCKed on the dleEurttt that la Irt tha aalected ar default drive- 
Check tha CATALC£ display! thd rtrtns df LOCKed fllea ars preceded fay Art 
avt«rUlc 1 * ) In the CATALCK dlapla;^ A fila ia LCCKed to provcnC 
accidental cvtr- yrit^n^* Uaq aiuithet diskette or UULOCK th* deilrtd lil^w 



STMTAJf FSaOR (ONEHH GOTO cede - 11) 

Qccurs When DOS anccruDters a syntfix error In » DOS tniAnd- Chad the 
Qianual for the ajcact ayntnx required far the comnund In quasClPTt^ Th* 
pmblent Tn£ly ba a non-\'Blid Eile name fsee AppeF>diH ?1 ^ an incorrtct 

paraae tar oyu^ qI ^ a ml fl^i patdne ter^ a mis slog or Inccrrect BtJuraCot 
(uauaLEy a CCWima)- ThlA TTEd9a^ ViLl sLso arl^e If a paranetar value or 
CDOimad quantity Ja a negative nujtiher dr Is greater Chan 63^35. 

naraLy^ evtry DOS cofmind tftUAt^a rr>c Applcooft or Integer hASIC SytitaK 
Error maasa^ep Th^a uaually means that DOS haa not haan booted or has 
bacome "d 1 a c oiuta Qt ad" Fron input and outputs Try prassing the BESET hay 
then typing 3DPC to reconnect DOS; or, ra-boot tha diukw 



HO flUFfEHS AVAILABLE [ONPRB CQTO eod* - 121 



Otrutfl vhen a DOS cuMi^nd requlreH Artother fll4 bufEtfr Ecr Input or 
output I and all the avftllable fl^e buFfers ^ra eiraady In usei On bMtlrtg 
tlia ayatcD^ DOS re^erve^ etiQcgb apace !n the Apple'^l meaory for threa 
]nput~and-output file buffers^ A subsequent MAXFILES conwiElnd can Iticr^ee^ 
f>r dptreahe the number ^f aVAlldblc file buffers* and a CLOSE coomand ddd 
rel^aac file buffera currently in ofle for text fil^s- 

Many DOR conmnda 4iae ort« flit buffer for input or output during their 
e)c«cutl<in» and then rcllnqulib that bufF«r when execution of the command 
han t«aA&d« 

When a text fila is CF£Ned^ a file bufftr la daalgned to that file Tor 
input rtnd OoCpuC- Thts bidfEer reMlns ±n uae^ generdllyp Urttll its fila 
lH CLOSEd either Bpeclf ically by file ndH Cir by the napteless CLOEE that 
do-allf>caten all the teitt-flle buffera* A Ceit flic is not automatically 
CLOSEd by a proRTam'a conine to aa end« To t[}rt4«rv« buffer apace^ CLOSE 
fileA as acioti aa yt^u sr« thrCPUgh UBln^ them. RemaaibeT that the rtCKt OPEN 
Will re-Aet the positlon-lD-th^f ilA pt^inter to the File's beginninB- 

'Ehr HAXFILES coomand can be naed ta increase buffer apdcc baFore VTitlPG 
the program or loadlpg the program inta EDemotyi Id^reaalng TIAX^TLES wrt^Ma 
HIHEM down» and thi» ^an erase atcred Integer BASIC proEtaio llrtca or 
ApplesoEn airlnfttt- Chdnglng HAX^tLE? In the niddle of a progran cda b* 
ea pec la lly cLangarous ■ 



HLR TVPE KlSHATCn {OHEHfl GOTO cade ° 

Occurs when a DOS coasnaod attenptB td uSv d fLIe nAVe that La alt^ddy 
assigned tq a flit i^oae tile type Ea inappropriate to the preaeot 
coDinand. IF yog are flure tlie coHiand ta correct^ kiae a file naae that la 
niic rttv on thfl dlikecttf. uae s different dlalc^tte^ RENAME tha eTiAtlng 
Fi^e QT L»EL£TE tha nlatlrtg file- 

Thla oiAdaagfr drla^a from sevardl dlffarent incDrract coublnations of DOS 
cciHnaTida wltit eKLsting file type?- Here are tbe cortftCt cDtob IrtA t i Qna ; 

LOAD Bllir f, SAVE 1 £ BUat he an Appleaoft csr IntegeT 

BA^fC prOBTOiTl file» 

CHATH f f must be an Intag" BASIC pr^gr^P file- 

OFtra f, BEAD f, WITE £. f Buat he a te« file* 

APPEND F, POSITION F, EXEC f 

BIJ3AD fj BBUN £p BSAVE f f rauat be ft binary prograiu or ddts file* 

TIl^ KTCvclrtg pTogtajD'a File nawr dpbclfli^d With THIT or UPDATE^ 
DList refer to an Apple^^oft cr Integer BASIC proaran File- 
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FROGHAH TOO LjUGE (OHEKA CCTO code - 



GL-curs when a DOS copuvfld Attempts to plAC* ■ dl>k«ttc FH* Into Applc^fl 
nKKhorr^ And lEEndn the n^lL^bLc HHry Iniuff iciartt to ccmttin tht entire 
flic- Vou lor A prtivloud pn^gtAnJ may h^vt a^c HTHEH c(ki Icrw for the 
cuirrdnt toelc^ or d ISTfte ElflXFLLES tu}i h^ve Bet BLHffl toQ low. If you set 
the nuoAer cp£ file buEf?tA to Ehri*i!, a«lng ch« ttmvund 
HAXFILES 3 

then Hintn ilflL be retunsed tc tbie booted vbIu^ gl^Cn Irt AppendtJf Dh Table 

IE jGu dT6 111 Integer BASIC, and KIHEH 1* flet Icrv (to protect 
hlgti-cEQolut L4fi frcrren MHiryp for inBCdn^p), you nuy c]q?«rlvncc ttcublr 
On Bhlftin^ te dieketLe ApplesofL^ Diskette ApplEBcft ccczupleE about 
12. 3K t^t [k*moty, but B Bhift to diskette Applesoft f^ltb or LOAD or 
BCJN) dpes npt reaet HIKEM ta DAKlDM^m. Vhen trie* to Idld tht 

Applesoft progrdta from diskette^ the hsesec FRDGIIAH TOO UlAGE vlll be 
glv^n If BIHEH iB below abnut 13100- Tb« Byateio vill bd left In lutbget 
BARIC A^ln, dud ydu nu^t bet UlHEH biigfier from Integer BABIC^ See 
AppAndlK 0, tdbLe 2 tor your Byateni^E raaiinuin HIT-TEH with DOS nod tKree 
tllo biifl^TSF 

tn deciding whether or not a prograTU vlll fit into the EvslLsbLe venoryi 
Dos looks only st thE nunber qF dlslcett^ geetora i^CCMpled by th4 
progranr- In gmetai I the progrem doEB not coTrrpLetely £111 the iHBt sector 
{2^6 byte^l, hue no? Ignored Chlii fact. nOS conq^res only the bigh-Drder 
byte of LOMEM flnteaer BASIC) or HIHEH [AppteaoU) With the h±ali-order 
b^te of the projected end-nf -prDgrsm Location* TbiLia a prog^^' whlcjh 
should [it into wTnory, but which would leave |e^^ thun bycflfi of fre^ 

PHtndty after losdlng^ may cause the PROGRAM TOO LARGE Hs^age^ SometLneA 
this cafi be cv^rrecc^d by WVlng HEHEH C»r LOMQl slightly, to chenee the 
hi^-order byt^^ brfpre Lpadiag Lhe progrdn-^ 



HOT DHfiCT COMMAND (ONEBS GOtO coda ° i5) 

OtCure when yon try to use one of the text file conandp AFPEHD, f3Flll» 
FDEITION^ READ or UKTTE [rom 1 rmned 1 at e -e]^ecu 1 1 on oude^ TheEB DOS coDnands 
cBEi be u«ed only ttom wichiji FRIEfl Btatemeuts In projr^D llneP' 
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r OF DISKEHE 



lih iamtr« tnED a SnqntntlJit t«c tile 

il% Uqh BBS MUna tan TvKt PllaBi Cvaaral PEHwdBlfi 

lit tbB PIMtttC* atTiKCQIT 

m IrvA Bit 

track B«cMr AiiMPilBift oi^m 

13i BatTl«UJ,H« IfiJafmciart £mi tba DlA 

ii7 tEtSiit^ Irom B bodnr^EHTH flia 



TlitB appmdU tells hrti IntoTHtlon ia Qtored an a didkettcp and h™ DOS 
r GEM? Qib □ rs vherB particular InfomfttJcn has be^d etoredi 



In the fcllnvlnf^ dlBcu»alon» 1 dolldC al^a f E } or tli« label "H<«" 
preceding A CTUTTdsGr indlcatea that the tKLnbtr i.M expreBSed Id heudtclFHl- 

OVERVIEW OF THE STORAGE PROCESS 

Id tbiE DiaL II aysteh^ InfomatiGn is recorded OH A diskette in 35 
CDncentrlc zenea or b«nd«p calltd ttadka^ Tfi«Be tracks arc nunJ^erei] fzDji\ 
tnck 940, the GuteraDBt* t^ruuBh UtaA $22, tht ^ nnermus C - The dlak 
drive's recDrdIng dnd readlTie head cin be iDCPVed In and cut* to tCOp dnd 
homr mer ea^b of clleae 15 dlffer^t JSdnes nC the spinning diskette. 

FurthorBVrc. the lan^th of e*ch track on the dlalc^kEt L« divided Into IG 
fl«BB£otEp railed SflCCOrap Theee ae^torp are nu^ered froffl S0 through $7, 
ani} up to 256 f^lH) bytes of informttcn can be stored Ici ^ach Jector* 
Duce the dl^lt drlvc'a recordlqa and Tfladlng head la poaltfonod Cnver a ^Iven 
tT4Ck, ihac cr&ck'a L6 aector^ Iflll pdae under tbE head, onr aftet the 
otherp each time Cht dlaketCe nplna ground- DOS aCtfayE record? tnfonULlon 
on the diflkecce iu z56-byce chufikSi tjcaccly filling Dne sector edrh tlm- 

To etore InfomwtlDci on the diskette, DOS tint put^ 23fi byt^a foub 
aector'^a VDrth) of the lofomatlon In an area qF Apple'a nemory cpllei fl 
file hcifter- HheQ thla file buffer Is fuLl, tht 1 nf oroia t. Id n Is stared In 
one a^ctor cm the diskette^ Th^n DOE fills ^pl«'s file buffer vlth the 
ntKt 356 bytBs of Information and ator^a chflt informs tie r> on the diak4tte« 

In neneralp DdS will be^-Ln stcnrlnf a program or text file ^her^ver It can 

find sn unxtaed sector ou the dlakettc-- UTien that sector la filled with 
lie bytea of InforMtlOn, DOS fioda another fm BetCOr, perhapa on 

another tracks and CDUtiTHjefl to record Information thvrt- Thla process 
contlmes 4jnin the eotlte llle haa hecD stored^ 

To rcBamber which ^eCEOra of iriiich traciha contain the Infonutlon for ^ 
particular fllep DOS Bakes up a llat of eAch track «nd sector uAed, aa it 
■ torea the file* Then no& atorea that Jlsti Cftlled a ErackAector llatj Itl 
ytt another free sactor (or fl^CtOtfl) on the diskette. 

riodlly, the file'^a jiamep Filf*typth tenfctli In aectorBp flnd the dt^b^ftre 
location af the fLle'^S cradt/gect ur list are recorded In d Special srea of 
trucJt gi] called the directory- At this dniep Coo, the dlahetke'^b track 
bit mp is updated to correctly ahow which AecCors of each track art 
currendy in uae* 

WtmNG INTO A SEQUENTIAL TEXT FIL£ 

Entries iu text file Ci?n«lfft of I to 3276/ charactera stored rh«fr 

equlvaUtEt ASCII codes and ended by a RfTURIU char^citer (either ASCI[ $0Q at 
ASCII SfiD)- Each Such entry la calUtf a field* 
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In a Bc^uentEal teKt file (no Length pAraneter specified when the file MM 
nrpNed), fleids are stored ImAedla tely following tAch other (aoe Chapter 
hj. POR writes the ffrflt byte of each neV Eield iHDedLately followirtft the 
RETURN character that ended the previous field [onle^a atherwiee 
instrocte^d by a Byte pacauiet^r)- Each tiioG the file is DPFHed^ DOS 
fOTftetf the current pOflltEon within the? file, and starts WRITEinft a^atu In 
byte t lagaln, unleaa otherwlae instructed hy a Byte parameter) - 

In order to re-writft a partlcolflr field or character within a aequentlat 
Hie, WRITE cm be used with the B (for Byte) parameter to hegln wrltiafi 
at the tptclft^, flhaolute byte of the file (the firat byt* In the file 
Is byte Bp th* next ia byte 1, etcO- The byte speciifled may be before or 
after the current position iu the file- 

s 

Tl Ifl verj difficult CD rBnepher eMccly whUh chacaccer sppeatfl In evecy 
byttt 0S 41 text file. EBp*cIallT in a sequenilHl Emit file. Fot thla 
[Cdson, use of th« Byte pflrflmOtfiT in sequeatlat te»l fllM U not 
EeciUDBN^ed - 



The POSITION cOMnand can be udcd vlch an S (far Hela L Ive-f 1 eld ( 

paraHCCT to TWtve a polniar ahead (only) rhrougli th« iile a apeclCled 

nuinber of Elelds celgElve to Che curceal position in the ille. & 
prbftran portion such as 

12B PBiHT -OPOJ HUMES' 

i3e PSfWT Dfc -POSITION NHHES. Rl 

3" 

14B PKIHT !>•■ -MRJTE NPP1ES'' 
tea PRINT "flPPlC CCHPUTBt" 
LTV PWINT Irt -IXOSE Hm^-^ 

Hill atCBBpt to WHITE iVie chflractera APPLE CQHPDTEB Into the NflHES file, 
heElnning In Ihe Elral bytF of the fourMenlh field (the fllflt field IB 
flelaclve-Eleld 0}. 

PDSTTIOB cfln oovt you Co the flrflC byte a£ any given Eleld lurlati™ to ibe 
current pnalCion in a aaquPntlfll text file- If yOU then re-W^TTE ctifll 
tltia, howevpr. you muat mflks BUre that you re-PHINT gxactly lliS IflBe 
niiBbcr Of chataciBiH that you PBiEiTed in that Elald oriEinally- IE you 
PHJHT fducT chacBcteiB, ymi will have created tvD new fielda: Ehe field 
you 3ubC PKlSTed, Bad ths tall-end of The prlBlnal fUld you Uete 
over-urltlng. If you PBINT more ehacactera than thfl orieinal field 
CjinlfllTied, you «lll have nve I-ur I C ten BoDHI of the chJtiCleCa at the aiact 
Ol llie neat field. 
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WRITHG H10 A RANDOM-ACCESS IBCT HU 



For d randoEo-AfcesA t^xt file, a LeuECh pnrofnectr ±b speclEl^d when the 
file 1q OpENed- Tht Length paranecer doteniLiDeE rh& numbtf of bytes In d 
reoord, «hlch is a field ur a cnllEctti>tt M fields thevt IWS treats as a 
Linic* Each rci;urd In a ra nd tjm-a cceaB tevt [Hp is lllcE a fiCp^tate 
sequential tfl^t file whcjSis maxlnitin total Cengtbi hq? b**n specified by the 
LCTiBth paramtttr. As lofin d3 ynu atsy ulthii] that naxlnufn Length, you CAn 
WBITE and re-VRtTE all yai} vant^ vithout afEuctlna aiay other record in the 
file- UEITE can be uded with the R lEor Record) dud A (for Byte) 
par^EHters to begin vrlttng Into any byt« of m qpeclEled HctFTd^ 

Since aflj DOS coqiund vlll HemlutC WlTE-lflg , you cannot use FMITIOIJ 
to juTDp ahead Into different fielda vlthln the record Specified by the 
WHITE couuMUd- 



MS uses the Ltngth pari^rwtcr to caEcuLdte where td vrlte the first byti3 
Ot each record ( L bytes beyond the firat byte ot the previous 

reMrdI- DOS almpLy skipa over any hytes between the prevltrua recnrd'q 
lajtt character dnrf byte L. The bytes skipped over will continue to 
Contain uhacever values werd stored therfl dt soiDe e^rlUr time (aaa the 
uxt section £or detdlla)* 

If you jitteapt to HRItE mre chdrictera in ^ rindoTD-access record than 
you apecifled In tH# Length pardoeterp all the characters ar« itOfed 
correctly cm the dUhecce* However, when you hefilfi WHITEing Lo the ni:itC 
record, 003 calculate* che new rei:ord'a starting pcraltlon aa if the 
previous record had been within the specified Length. The new record ttuia 
□vervrltee the last chitactera of the previous, over-HL»d record, 
including the end-Utking REJURH chdrat^ter nf the prdVioua record"* IdBt 
field- The result la Hsay- 



HOW DOS WRIIES MO lEXT HUS: OWEftAL PROCEDUflC 

When you SffilT^ A field into a tent file, nOS first checks On the diskette 
to sei? whether nr not you have already atoted informattoci in Ehe Sector 
uhlch should concdin that field- l( your file hM Tl*V4sr used that s&ctor 
before^ MB places Ecrofi in all 2^6 bytes of an Appl« file buffer, and 
then Lets you put your Information into that buffet for later atar;i|}e irt 
the correct diskette sector* The contents of the file buffer sre Stored 
on the dldkette when your InforEkstion has coinpietely filled 2^6 bytea ol 
the buffer^ or vhen the f[le le CLUSEd- 

Thus, when you URITE to n particular Sector the flrat tine , unused 
bytea ar^h given the volue aero- An sttupt to READ A byte contninlng a 
tero itht ASCII codfl for the nul] cheracttr) *lll result In th« Hdsniie 

EWC Of DATA 
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But If WlE llndH your flit hdei already atored InfonutLon In thfl aector 
which should Cfrttain the field that yoti urt now WHITElngp it reads all 256 
bytek f^^^n^ that aector intc thi> Apple's file buffer- After you have 
f-hftngod Jrty of those file-buffer hyces to contain your new Informatlnn — 
the HRITE, PUSITIOH faequentlal filea only) dtid PBtUT COimndnds take cat* 
of thia Ei^r y4u — DOE then stores the buffer^s ccntent? ri^ht back IntiJ 
the thr Aame diskette sector uh«r« th&y i?r L gl Eld C cd - Thfi tonctrtts of the 
file buffer ar^ vt^r^d back on the diskette when you attenpt to change any 
byte not ip tl^e Sector thdt Vd^ r«ad into the file buffer^ or when chd 
file Is CLOSEd- 

Thifft, if you HSITE mort inf Ormation for a file, and DOS stores that 
CnfotiDaLion in a di^kect^ Sector Already being used by your filep thlA 
will not rewrite Any zeros in unused bytea. Any of those sector bytes 
Vhlch you did oot re-urlte liiEl continue to contain vfaatever inEornatlaa 
nlRhr lidVt? been atored there before your WRITE cOmsi^iid^ This it true of 
tht unused bytes at the end of a sequeptlfll ttKt Eile^ and 4t«0 true of 
the unused bytea in ejich fixed-length record ot A tdndoib-accen tejLt £11e« 



COHTBITS OF ni£ SiCIDRS 

How tl^at ycTi^ knOW the general prooeaa of recording 9 file on dlakettCp we 
can diacua^ each elernOnt In note detdil^ The actudl information flCOredp 
sector by fl«Ctorp Is different for each type of file. 



FOBMAT OF FILB SECTORS 
lor different file types 



Pile 
type 

fboth 
types) 



Sector 

1st sector 



Subsequent 
aec tors 



Bytt 



2 through FF 

All 

bytea 



Cooceocs of bvt* 



Program leagth» low byte 
" p high byt* 



Tobenised program 
Tokeni»d pros ram 



Tout All fttl ASCII tepresontddon of 

Sectors byt«0 tentc: ot>e byt^/character 

($H vrka end of file) 
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Subsequent 
Sectors 



PyU- 

> 

I 

z 

3 

4 through FF 

All 
bytes 



Cant«Rt« df byte 



EtdrtlTi^ RAH addire^*^ low byte 

, hlab br» 

" p byte 



Blurr data 



WE TRACK/SECTOR UST 

As ^ \\l€- IS tLored f^n the diskette^ DOS D^kcn A IJsc of the diskette 

loc4tEon5 u«ed by tht Eil«- Thi« trecik/sector List Chert «tor*d on the 

rilAkcttA ±0 the une h«j Th« itKll ns vtondv Ttu contA^tft of « 

ttedt/Kctoir l£»t an a« Eoilwat 



Dyt« 
<BaMi 

E 
Z 



3 throu^ 4 

S - 6 
7 tbraueh B 

C 
D 



Flnt 8«ctor of A 
THACE/9ECI0V LIST 

CmitMtJ of jittt 

Hot uattd 

L1tik= trr-icV n^imhtT vhcre cantliwatlon flf the 

c ^^ct/$ecCor ILat Bay be Eound* 
Link; Setter nuTTiber vhere contlfuatlon m the 

track/aact«r llac mff fonnd- 

(Tf botb brt« Of LIi* - 0» no llik-y 

Itot Uattd 

SactoT baH atrnbar (ceMDtH nrqimg ^ 12Z Hcton} 
KDt u*«d 

traot: mitf^«F of firat E±le Q^ctor 
Setter " " 



Track number of serond Mle sector 



19 

It 



Trscik THiuter of third file sector 
Sactor M t< ^ 



Tracih m^er af L2^nd file Bector 

SeCttPt " " " M FT 
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le iiitr tnKk/nfCtor pelr is 0/4 this Iridlcatea ah tmauigned aectar 
(ttBHallT Che end <>f th* flle^ Although tost filet *«T contain •/# 

indii^Atora for vi? Aa-yac-iiuaaltA«d aaoton irtwr* Cvt«re bjtu or 

rrc-ordA Hy be written)* 

Si I hf, M4- n t sectors of C h e 

ll^i trttt k/ee^ctor i>BirA) At* LdentlcAl to the first sector deetrlb«d abon, 
aKCapt that the t ract/sector pAlrs refer to subsequ^^ri t ftroupa of 12? fll* 
etctora^ Also, LliA bytei 1 and 2 will b* dlff^re^t for esch sMbstn^uent 
a*ctor^ Each UHh pair giveii DDS th« diskette location of th« fiW 
pD£tl4n «f cb* traok/aaAvr ll4t- If bqeh brtaa ot the Link ara Cfat* 
lAdlcatu the fleal portion of tbe track/aactor U«t> 

uith A text fll*, OttXj th* era(A/M«er palra for tho*^ sectors Actually 
conEAlcang IttfOMlClan appaar t# A04-Hn In the crack/QeQtor list* DOS 
calotUttta Eb* torrMt noj fj^t^ian for cha tt*ck/*e«M within the Uae* 
fUUai H«MlS4ftd ErKc£7neCor pairs vlth Hton^ 

Thi]ftt if the Lpnp^th parameter for A raDd«~acce»Q file la 128 (two raoorde 
P^ r ^Li-rorJ and you WRITE only t& racord miAer 27Mv thlrtetn diakatc* 
sectors rTv v^l^cI : one for th^- contents of record number 278^1 and tlrtlw 

for the sectors of cIll- r rai^k/qpctor list- Thn.- ^(intents of records niiinbar f. 

Ehnu^ 26fl3 may soTT^t■^J/ r-L^<?apy LJ'i2 i^c n [ -i r'^ ; hut untlL tho^t^ t-L--i?H^rda ar« 

vrlttn* titay do not uae any dlAkette Spac^^ The trsck/fieccor list givlns 

tfoa locatlow of ttaa aactar* uaUUlfM Tacorda midnr f 2fiA3 d£«pj 
4l4ven Hetora* 



THEDUnm DiMcroRV 

Op every ttlTUaltmmd dlaketta* trmA $11 la t«B*rv«d tor InfoxwWon 
coDCHBlng tliv «Hit«ti of tTi* dlakatta* Ttala ia DOS mtsm cbt 

dlwcMtj cDiLtalnlna, for each fill, tlia filr'e Its Cll* type, the 

Matrtr ol MctQEB occupied b>r tbr fUt fWH) ZS6>, floA th« dlika»« 
locatlDD the f11*'a track/aedor The CATALOG cviHid guhh 

■oat of tlilB InfDnHtlan u ba diaplar«d on dia acrvvn. Bad aactor of a 
dtakatC* dlncEoi^ i4 fonHttad aa toXldni 



tyta CBpkI Contanta at byte 

§ ttat uaad 

1 UAi Tradi DiiiApr «here cominuHiion of ihe 

dlractcrjr may be found (nanally HI> 

2 Li 1* 1 Eactor nuDher whart continuetlua ot th* 

diceciDTT may ba Ccmid 

(If both bytm of Lint - fl. no link-) 



1» 



3 tJirongb i 

2E thtough 50 
51 thmt^ 7S 

7& through 96 
97 through B9 
U throu^ DC 

IW Chrdii^ FF 



Directory entry fpr HI* 1 
Directory tntry for £±le 2 
VlteccoTj nciT for fllfl 3 

niHctory mtvy fcr fU^ 4 
UnctMy maj fox file 5 
DlTKtnsr mtxf for file S 

EUnctdET ntET for filo 7 



(*44 btior) 



li' 

it 



The file iiuii±>erB ahoufi for fht^ JiH?vOrt dirtctory entries ere arbitrary- UhM 
e file iB DELCTfid^ DOS ma C kg the directory entry far that flL*- (lee 
fdlLowlTifi teblel* The nent time a file 13 Stored^ DOE replaces thp ol4 
Hrl^ed dlrettoty entry with the directory entry for th* rifu file- Thue^ 
Vhi]< Dos otlElndlly fills the dlrecitory in the order ahfrwrij filt 
DtLFTEfcitis aoon r^-ndtf this otdcr me aning le se * 

Th« dl«k«tt« directory begins In track $L1» vector $f- If iu>H Apace ±b 

DfBdw! CO nore Additional directory «iitrl«0| flACtor >F i» Llid»d to cUCor 
SB* iC ttlll Dore epact is needed^ sector $E lo Llikad to BHtor ntf 
vo OAi thnugh loctor £1 i ThiA aIIiav ch* dir«tory to^ Mtw^ dtKctdrj 
■Dtriov for A MurlwHft of 1^3 dlEfomt f llo^^ 

HACh dlTOctoET ntij £■ vrlCHu in tht foLloving forwtT 
DlMCT(n!Y EHIXT IOTl ONE FILE 



1 

Z 

3 thvHiBh 2» 



Track hLzfllii-r o( th« fll«^fi track/sertor 

(The original v^Ive ts copied into 2fl and th^- vdlufe 
of b;te t i.^ dtiuii#d to $f¥ vhen the file ie 

Sector miiiber of th* fll*'* ti:4c1t/Hctor Hoc 

Pilo tjp^ dlAcoHbn on tha uut p4g*> 

?llft 



Sector ooonti th* nuiboi^ of diak«tt« teelor* 
(mo ZSfi) OHupUd by ttm filo 
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A dlroctory oatry'i ralMlw JaM ■p«Uiet oaoh byto Ttthln the eotry^ 
jithpugh each entry stirtB ot dlffar*iit Actual hyto AUiibu wltbtn the 
directory «ecCor» To flftd the abeolute a^ctor byto oOtto*p«dlBg to a 
rc-laLlvi- byte* add the relative byte to the entry'* flrit aSaolota aactor 

liyiri' (n-i listed In the prevl^^il* tablel^ 

fi^H-jiii-iH- only one byte la used to store a [tle^S sector count p th* fflaxl»™ 
dir^t-tory sector cOurtl le ?55 (SFF)* If ^ £11? exceeds 2^^ fitctora* its 
Bettor cnvnt laa displayed by CATALOG! starts over again at 931*^ Thla 
does nCPt affect use of the flUj but may glvf sn erroneous inpresslcnn of 
hou full tha dUkette is^ 

Tli« oi^E blta of a flle^a type-deaigdAclag bytej relative byca number 2 
Id a fll4^« dlrutory aotry laa£ pnvlAi4 tatala)^ arti aaaliUid voloaa aa 
foltovai 

BTTB WOICIIDW TD FILE TWE 

GAUlOG 

BTifcol Ftio tTM JaaijtQfttacL 



7 « Ptlo ia loekad fvtlte pTOCact:»;d> If thla bit ■ 1 

Tfla ia wlocfced <frOt protacta^) If t1il4 biE ■ 

Exp^nelon type lor EuCure use ^normally zero) 
J pp II iq II II ■■ 

^ « PI Hi II II PP " 

2 B Bloary file If rltf* bit - 1 

1 A Appleeofi: USIC fUa If this b£C ^ 1 
I Intogot BASIC flla it thia bit - 1 

r ton ftla ir blta # tbtwih 6 an all aaro 



Tho fila typa ia dotofiifiiod by A l-^it arpcarlnK tA of tba blta V 
Cbroaah le bica I tbno^ ^ ar* aU V-^blttp tha -fila typa dcfuolCfl to 
A t«A file. 

Iba Ella'a type-designating byta «nt tliut Eoka on C&a f ollnrins val^aat 
VALDES FOR BITE CffilOAtOG FILE tm 



File ValtH ol typo hyto (Baa] 

Taxt « 80 

lUagar 1 «1 

BlMty * ** 
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VbUME UBLE OF CONTEKIS 



VTOC<- tbe VTOC Atore0 the Follcvlng lufdnttlcnE 



VOLUME TABLE OF CONTENTS (VTOC) 
Track Si 1, SecitDf ^0 

^PMMtotlM^ 





1 


I 


n 


} 


$r 


3 


i 


4 


$ 


5 


§ 




1 Ehroii|1i 



7 tbxvt^ 26 
27 

28 dircHiah ir 

» 

31 
32 

33 

34 

33 

3fr 
37 



7A 



n 
n 
n 

M 

23 

ar 

0L 



Not OHd 

.TRidi m^ar of flnt dlnct«y sKtH 
BuCor V ' V " " ^ 

DOS rtlcoBa mnhbdr 

Hat used 
■■ ■■ 

ruakfltca vdIuv nuitber (default: Sfe] 

HaicU>uiir=iniiib« c< tn^/B«E« pain ^■■tUf 
la flufa HoEfV of 4 C»clE/*(ctvr llmt 

lot OHd 

riu'^i' f -111 f i^yleg Lire .i nktuk f iir 

track bit oiap9 1»e« nexc Z pages]: 
uch l-blE '•ublai c« c£..th< 16 

Hctfln CO ba yHd In mrj Enck' 

TJuinber of rrsikt pec ■fi'^lcrre 



Vuiriter af liyE€B pei aectDr> icv byte 
high byte 



I 

T 



4fl tlirougli i3 



Trach bit map 
Trark 1 bl t wp 



not dVdllabl* 
to tKe uaer) 



44 rtci^3 
4fc and 



XrBcV. 3 bi E ndp 
IP II II IP 
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4B ud 49 
4A ADd 4B 



}S tod 79 

;A and 7B 



[>**erlpttoB_ 



Track U bit bap 

H ■■ ■■ 41 



rricfe nl Me VHP 

rr n V ■■ 



7C lliri^yfth 7F 



Track $11 bir map (Directory 6 VTOC) 



99 4nd &J 
fl2 nd 03 



c0 ud Cl 
C2 ud C3 



Track S12 bit EDap 



921 bit ktp 

M n " 



Hot iwid 



TMCKBrTMAP 

Starting in byte 538 nE the VTOC (set prevloua tabLcl, tijh uen t foiir-bytB 
grou^B each ccntaln the track bit inap f*r njne of Che dl skl'l U' ''i '^'^ IrsckB. 
The HItaiieHB*nt of l-blta and U-Mta within a ttaik's t-!t aap sTiows. 
Villxh AeECarfl of that dlsk*tt« track arv cucrenCly in u«e» and idiich 



■flcton It* fra*. Th« bit Hp fae U«b tnck 

mCE BIT KV 



Designa ted 
Sector 
lit l>!t5l 



E 
L 

C 
B 




ctw foilHliie tonati 



Bit 

7 

6 
} 
4 
3 
2 
1 
t 



rtaalgnaied 

Sect oc 
(H«_Kj 

7 

S 
4 
3 
2 
1 
$ 



3rd «.4Eta All 
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It e Mt In the track bit nap conEialFtB the vqlu^ |, thf* ^CCtor 
COrrCBpvndlng that bit ±a free* If * bit In th* m*p CflnCdii]! th* value 
fl( tht decitar corrcBponilinfi to that bit [fl Currently In use. Bits urked 
**Spare" in the table above cantjaln tllC valuti (j tli€de bits are r^jt UACd^ 
THe Crock bit map fj^r a typical crack ibiBht appear as follcwa: 



Jpt byte 

j» e e I J 
H n t t H 



TYPICAL TRAfl^ hi T HAf 

?nd byte 3rd bytfl 



J I I 1 J ] L J 

t t t M t f t 

7 6 5 4 3 2 10 



^ecttitfi dealgnated 



Spare 



^th byte 

e « e ji p 



Not USAd 



1 - Free ureter (AtJurning the c c r re Bpn i bit t1l« mul^^ 

VTOC byte? cbrDugh ^33^ Lb alfto 1> 

P - Sector in L^e 



When a Elle 1b beliiR Btered on th« dEsVtCte (using VniTE, SAVE or Bl^AVD , 
dn rntite track lA allocated tc the file dC Onet fkhEn pcaaiblc), ^nd Cbe 
track^B bit E«p ahvHTS the cntlrt trdch 1ti use* Theiip wben tb« file 1» 

CLd^Edp tbose sBctars net actually UB^i dr* agdiii designated mm fr«» In 
the bit up for that track* 



Seciars ^ctuaTly used to atore a filers 1 nf Ci nnft t icm , howe-srer, can only bP 
"set free" wlien that file nm* 1? OFl^Tfid- Suppose yout diskette contalTia 
a 100-aectDr EASIC file noned BIC^ far Instance* If yau now S>VE^ on the 

£dBfee dlshettt* d 2-S[^Ctor flit Vltb the arane nane ETC lovervrltln^ the old 
tll4) d CATALOG of tbe diskette vlll reveal that your ?-4ector flit niC 1b 

still uslnji up iW sectDTE* To Fr*C up UT^n«Cc«tfl ary ^ectcr^ used by a 
BASIC fll€ named ust the fcl lovln^ sequence of Qcmnanda: 

LOAD ETC 

SAVE Bin 

A slnilsr process 
blndry tilt^^ 



can be uaed r^LcdS^ unnecc^daary sectors usf-d by 



T<f reLtABt unnCcccsSary aecrors beln^ uaed by 4 text tlltfh you Vill have to 
EEAD each of th^ file's E leLd« Inta the Applet If ycu store all Che 

arrayp you can then DELETE tbf (^rlglildl FUe before URITE^ng 



ffclda In an 
each record b^d 
way to do this 
the field back 



k onto ttiQ difikette uslufi tht ori^tnfl file ndne* Another 
Is to rend oach ffcld Into the Apple and lirme di a te ly UltTTK 
onto th^ dinktCtb udlng s file nariE that la different frpi? 



the original fll^ n^lne' Wb^ F^u have read and re-vritten the last fleld^ 
you can D£L11TE th« arlgindt fll** 
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TRACK AND SECTOR AiiOCAriON ORDER 

EAch dlAk^tte coc^Edlni 3S cracka^ rhrca of which dra raaarvad tor l?D9 and 
one for the DlrectorVy leaving H tracks for the uaeri Each track 
Ct^ntalna l6 aectorn^ so all together 31^16 or sectord are available Cei 

tbe uaeri 

Stii^tora Arm flllad fcartln^ ulth sector SF ^d worhin^ hack Co sector 
Trat-ka are flrat fllltd BCATtinn with track SI? fjuat mide the 
dl r E Ct ry / VTPC Crac^ ) and proceeding Inward to track 522 (tbe Innermost 
track). When tr^ck ^li hmm been fllledi trackp are then filled starting 
with tr*ck Sra IJUBt outride Che dl rectory /VTOC Crack) and wnrkinfi outward 
Co trdck 93 (Che outemost track avsilable td the utier)- 




-akette 
TRACK ALLOCATION ORDEB 



SE£n:oR ALL{XATiarr ORlaeR 



Dlvkette 

Cover 



Plrnc 

Filled 



Last 
Pilled 



Ft rat 
Filled 



Last 
Filled 



Firfett 
Thml 



$12 



522 

m 



JF > 



REnilE VHG WFORM AnON FROM THE DISK 



Td cftrlEv^ ^ fll« tv^m dlsktCtc* DOS follovB the proc^atiii u^ed to Atore 
the file» but in teveraa^ After a CGsnnand Buch as 
LOAD FILE 
□ r 

BLOAD FTLE 

Eqt LnsC»rLCt» DOS noej tc th« diflkttt^'s f11« directory lii trAcIt SiK end 
EtndB t^ie ilrectflry entry e:^^^^!^!!^^ fwiwt FILE- This entry fllflo 
(^Diitainfr Lhc diskette locstEciD <by ctratk dud 4irccc>r) «f tht dtslred filt^'^i 
LrHck/aector Eiat^ DOS then goeB to this t rack/ Bee: tcr list, and teadfi tht- 
firEt track/EectoT pair* This pair spec if lea the dlslcette locatlcn of the 
first ecctdr ccincaioing rliti progran itantfd FILE- Uhcn he? read that 

first Acctot dE pro^rojiL into the AppLe. It teturna to the ttack/sector 
llfit tor the location □£ the progreui^t Bccond Sector, Bud SO Cieip 



READMO FROM A SEQUBHI AL FILE 

RF-AHing from a EequEnLial t&xt flld, vLth a prugran portion Bunh aB 
58 FflllO" D5; "READ TEJTTFILE" 
60 INPUT AS 

for tnEtance, the general process Tifce that described for LOADLng a 
prDgrajiL fila^ Bovever^ only the aee^tor Ci3ntalnJn£ the text flle^a next 
tteld IaIJ c:liarect«rB froa tho cunrtnt pasitii^d in the flic thtough the 
next RETUHta cherActvt) le r[?ed into the Apple's f±J.e buffer in reaponae to 
the INPUT coHmandd Then the actual Eector bytes th^t make up the dealred 
field Bra aaElgned to tha Tarlable A^^ Thla procesB 1b repeated if the 
field extends over TDore than one diskette vector- Ksch subsequent iNFffT 
CORMnd will tdusc rtddln^ of the file to teEube, fro^ the Apple^E file 
buffer If It elreed^r ccrntslnv the proper field, or by reedlnit another 
ditikEtte aectot luto thE Apple- Thla contlnuoB until the iBEt field 1b 
redd cr Bcme conB^nd CLOBE^ the flle^ 

By ualng the READ Eonand vlth tha B (for Byte^ paraneter, you can cauEC 
the ntftt TNFDT tc begin r4:ddlnA from the specified absolute byte In the 
flit [the file's first byi? is Lh« [leKC Is 1, etc-]. Tbls byte msy b« 
before or after the current pualtluu vithlu the fllei To UBe thiE 
parameter ef f ec tively p hoveveri you iDuat Icnotf the contentB of every byte 
In your fflcF the fOSLTlCW cdtnUand useE the R (for kelatlve-f leldl 
parameter to nove QOS^a current-poaitlDU pointer the apeclfled nunber of 
ELelds f oruerd l^mlyl throujih the file^ relative to Che current position 
In the file- Eactt tine you OPKN a flle^ DOB foTB^ta Ita current position 
In the file and sturt^ READEn^ a^ntn chc bcginnlAg of the file 

(unlcEa otherwise Inatructed bv a Byte parameter)- 

T^^^ IN PITT cDHTiAnd treats a respcmse soHvh^r dlff erectly in Tuct^ger BA^TC 
end In Applpditf^F If tertalu chatactera aach aa the colon or coma appedt 
In the re Bp on Be f leld ^ further charBcters In the field uy be Ignored nr 
aEBlgned to inultipLa IlfPUT varlablea (if anv)- For detalla, see the 
appropriate manudl for Integer BASIC or for Applesoft, 
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READMG FROM A RANDOM-ACOSS 

"Hie text-tCadlrt£ process Id ponewhat different when READlng Er*>ta d 
Jtpc-Clfled renord of a tdndiMtt-d^^ess text file (alBo see WRITING TO A 
HAhOOri-ACCESS FILE in thla appCndLx)- Jn ,1 rsndciB-accaEa tejit file. *ach 
record Le CDopofied of che ASM fiunber of bytea, specified in the Lenftth 
pdcnvieter iriien the file was DPCNed prior to IffllTElng the flle^ Uhtrt thi* 
Edne file la OPEHed prior to AUlUng It, an idecitlral Length patamettr Is 
Klven^ To find the beglnninB of A pdrtLciilar record Ispecliied by the 
READ comand'fl R par«»ter) , DOS uaea thd Ler]gth parUKter to calculate 
the nuiDbet oE byt*S occupied by dll the precedidg retards* That number Ie 
then dli/ided by 2^6 (510^1 tP determine how iDsny file asccors DOS mu^ 
eV-tp <^«r to reach the aector contdlnlng cbe desired record. Thed DOS 
examlnea the (lie's tr^C^/sector IlBt and findti the diskette location of 
the dttslred ElJe doctor. Finally, DOS r«dds the correct sector into ths 
Applets file buffer* Then Che correct hytes CEn bc t^^Ad fran the file 

hdff*^r- 

s 

This E9ibe tttr level prn^eE^fi would be followed even If the tent file bdd 
orlglnellv been etared oe a apguenciai filo, i^r ea a randoat-acceBE £il4 
USlnH S completely different Length- blindly Cfllculatea the Eectr^r 

dnd byte pPSttlon Pf the requested record according td whdtcVt^r LeTIJth 
parameter you apeclfy when yCiu OPEN the fUe prior to READlng frail Iti 
reftardleaE of the Length pdtdbeter (i£ Ady) thlt Vdfi U^ed when VKITEldft 
the tile In the tlrst pl^ce^ 

By using the READ camend with both R (for Record) snd B Cfor Byte) 
parametera, yOu Cdn CAu^e the next IMPUT to begin reading frdtD the 
Bpecifl{]d abselutt! byte Ln the apecified record teach record'n flr^t 
byte la the next Ie 1, etc-)* Thi* tyte niHy be before or aftet chs 
current poaltloo within the t^tord* TP use th^a paraiDeter effectively, 
however, you rauftt kdOW th* contents of every byte In the apecified r«COrd* 

The POSITION conufid^ while ptluflly ii^tended for acceda ro BeguentlBl 
fllesp can be used with the » (for Kelltlve-f leld> parameter to mcVt 
DOS'd current-pnaltion pointer the Specified number of flelda forward 
(only) thrpugh the current record, relative to the <jurrent poaltinn in the 
record* R1^[> Id used with the B (fot ^ccotd^ this tLqe> paraneter to 
move the currentTJdfiltlon pPlnter to the beginning of the desired record. 
■Jeing ?Dii[TIOH cgncela BEAD node (without rcEctCidg the poaitloD-polnter) r 
dnd dnocher READ (thla tLioe, with nO_ ^At^Mttt} re-lnatatea REAQ uiodcp 

Ejich time you OPEN a file, POS forgets ^ts carrent poaltion in the file 
and Btarta READing again frdW the befi^rinlng of the file (unleU i^chervi^e 
Fndtrkicted by a Byte and/or Record pardnwttrl- 

DUB keepa no inforaation for ypu CPncemlon the structure, Eornat, 
record- lengthy or f ietd-'length of ytur tut fllea* To use your 
rertd«D-acceaa tejct flies effectively, VPu DuSC keep detailed written 
InEotnat Ion dbPuE the Structure of theae fllea. or heep the iqforutLoci at 
the beslnning of the filoii 
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APKNDIX D 



L4V Hngarr Arm Dvar-VrlGtia Iftin Boot 1b« DOS 
Itl UHf; Ax«u Ifnd by DOa ud Rllbir BASIC 
^42 BtHBK £ct by Booting tUS 



TABLE 1: APPL£ II MEMORY MAPS 

A. MEMORY AREAS OVER-WRITTEN WHEN BOOTING DOS 



LfHZEtiun on 
Uiftheet UAH 



noves 
l Tlot* ? J 



7424 (?1D»|- 
fi9L2 (SlBMr 




il2 (S?«0> 



LocAtlon on 4 
ABE oynten: 

-A9I31 ($BiTF) 



Relocated DCS, 
on compJ-etinn 
□f boot 



7 byte* not uBcd 



Three file 
buf£«r« oE 
595 ($753) hytEH 
for input t output 



1I0S^ lAert flrat hooted 
[ Vote L J 



WS Relocatlc^n Code 
[ Hflte 1 I 



First atage boot 
«t«rtfi here 



■^lbbl#'' buffftr* 
UBcd during boot 



Henury addr^4» 

}Joce 1^ ThLB rnenury dr€a isf not affettad whtu b^oLlng 4 Slave diskette: 
DOS £b planed directly belnw the JUgheAt '^m HmAHry Ad4rfl43 ihat WJIS 
flvflllnble afi the ftyflCOta that IHITlellPed tht Slave dlakettEp whetbei: 
approprldti to the pruenc 9y4ten or not^ 



B, MEMORY AREAS USED BY DOS AND IITHER BASIC 



441^1 (SBFF¥) 



byteff 



Dlak 

Opcr^t 

SyfltoL 

{IE booted} 



Tnteaet BiSIC 
program llneB 
Btart at HIKEH 
^nd hul^d dovn 



Applleaoft 
fltrlOfA 
start at HIMEH 
and build dom 

* 



ftlah-resolutloti grapbics, Fbe« 7 
1 Note 5 J 



Higb-reaoLutlon graphicah Tage 1 

T 



Ncice 4 ] 



Elcbar BASIC'S 
VAt lab Les 

Btart Bt LOHEM 

and build 

AppLeaoft I 
pragru Itnea | 
push LOHEM up ^ 



t 
I 
I 

J 



DlH^ett* 
Applesoft 

u^edj 
octuploa 

thlfl >pJC0 

\ Note 4 J 
I 
I 
I 
I 

I 



UlEhout OOG, 
•Ithcr USIC 
~BBtB HIHEH hare 
1 not« 2 r 



Banting DOS 
iBta HTH01 here 
[ Note 2 ] 



•etB UWEH at 
IZ29I (STffl^> 
[ HntH 2 J 







BASIC Systen use; 
iCn«-r«aolut Ion graptiliis 


LoweBt UAH 




and te^t Bcreenp etci 


DCEury addre44 : 




" ^" DOS + Svsten 


m — ' 






tlcnltor and IkA^IC VuthSpAca 



TP lEltnwara) 
. and IHT Set 

LOHfn here 
[ Note 2 I 



Vectora 
IteaerVed 



Kate Z- [f TOUT iiy«tta U in Intes^r llASICp tha RJUBi pointer c«n be found 
flow byte flTBt. than hlgb bytej In Intatima 76-77 (S4C-$4D)- II your 
Byaten La tn APPLtSDPT BASIC, the HIHOl pointer 1b In locatlCFoa 



(e73-HSM>. sue fomt. Sea Trtle 2 for the value of HIHEH SAt by 
bcotlTtit DOS- iDcresalag vlll onve EHHEH d<ivn additloDal 595 

h^CCA for Eflch (lie 1]uff£T added- Ydt the locaClotifr of otJier App^e^oFc 
ptngi^aB potntfirfij cauulc your Applecoft It fiABIC Frag r^mmLng HSnuAlp 
flbPpendlK Iw 



TAB1£ 2: HimiA VALUE SET BV BOOmO DOS 

When DOS la bocCed, HtHEH la aet ^^cordldg to the a»unC: oE nnPT? In the 
ays ten: 



sister 


HlEbcBi: 


RAM address 


HTHEH: att 


by DOS boot 


H^p 










16K 




SiFFF 






2W 


20474 


5SFPF 






24K 


24575 








i2K 


13 767 


57FrF 






3«V 










4BK 


£9151 


SBFFF 




s^bte I Hate ^ 



Ho» The nunbtr -??136 cinuld alpo he writCCb but lateger BASIC 

will not actept nunbera grucvf than 3?767i Tn lotef^^r MSIC. bariar/ 
4ddrtA£es greatEr t3idn 32767 Bust b? expresaed thalr rwgatlvc 
equtVttlacCsp The negaCtve eqaiVdlaot u£ ao? pcaitlve decimal addrufl U 1b 
i n - 6!53« I* 

Koift Uaiftg hlBh-reaolutlnn gTapblcq ?d&e 1 erdStifi the ccmCentB of 

m**i5ty locaticTL9 8192 thtou^h IfcJH^, Unta&S DOS »et* HEHEM to a value 
greater than l638Jp an attenpt to uae hlgh-Tetialutini] sraphlcH Paae L iflll 
erase pATt of DOS« Thi^ neana chat you cannot uae Diat II and 
blgl I -resolution RT^phlCB fit the sane tine, unless your ByatPB contains at 
leaat 32k of DieDory. 

rt you are u^ipig dLfikette Applesoft, an attempt to use hlHh^re^olution 
graphics P^ge I will trafla part AppJciofL- Wicb cTtakEtte AppIeaoEt, 
you My us^ hlKh^resoluLlon grdphics Page 1^ only^ IF ^puT 5y*t«n »ntaiiifl 
at Least c^t niBmor^- S^^ Hcit« ^- 

Ucte ^. iTfiing hiah-^ resolution graphitE Page ? eraaes the conCenCa of 
MUlory iDcatli^ns 163afl tbrDugh Z457^- Uflleia DOS aete KTHffl to a value 
gresLcr than 24575» 4fi attempt to use high- resolution A»phtc^ Pag« 2 nay 
erssc part ot DOS^ Thl? mean^ that yuu cannat use Dlak II and Page 2 
bieh-reaoluCii^n graphics tbe UTU tLH. unleAB yCiur ajntem contains at 
Itast 36K Df pierwry. 
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DOS BfTRY POfliTS 



kiriTiilne tn EE-cOiUKCt MS (If pagE 3 ia Otf e r -«r i I ten ) : 

( CALL > IG^ 
4Br -25113 eSDW 

16K 7615 $inBr 

The HoDllcr comnHnd TDffL dlBpldytl Ihla Duinber Ht the tnp rlB^C- 



LoPAtlanB CQntalnEnB ETie atHll addco«» and lEngth oi a BLOADed pEUgran: 

SyatEn SHrC addreaa (low hjtp) Progifln length (loubylel 

ftlne paclpaJ _ HewadBclaal ppcimal _ HexfldeCllMl 

16K iKMb gZft72 l|a48 SZA6( 

To Ece Ilie HtfltCing addrcSEl or ImBbll alc«r a BIOM, Type 
PRINT P&fr;K(l0W bytel * PE^KUcw byte *1)'2^6 

FEDgCdV 10 find the DOS locatloaB con la inldR the QlHrlinB d^reSB 
and lenglh of ihH moflt recently BLOAH^-d piQa"^, on flnj Blie a^atemJ 

7 H * 3©4Ba WEH Dce-eOOT HIMEH 

8 T - l«H H»OHEST flOMtESS 
le * CWt <4J- ffEH CT|ifL-t> 

2© PffiNT "BSRVE FOO. fW77'?T^ LtT?' 

let pftiHT r**, -BLonP fdo- 
FOP I - H » ira^ re T 

6e IF <r> t > 119 OR PCCK 

<!+!><> US Th«N NEJfT I 
re PBINT "LOCfiTIDHS OF STftPT 

HW»£&S "J -il * 1 

aei FOH I - M * W T 

IF P££K Cl> t > 119 Off PEI^ 

CI * i> C > TMEIM NEXT I 
lOe P«INT -LOCn^JCHS OF LENGTH' " 

. s . " . " 1 ' i 

The 4dluea of H and T (lines 7 and fl> ace Bhovn foe a ASK arattD- 
ApfiendlK B, pSS* ll^i ahouB th« dOrrccC vfllues fot yoUF syateB. 
Thi* proarfln takEI «t»ai]I 2 BiilulPfl to find the desired LdchIIctiIB. 



DOS cbaiHctHr Input Bpd output routlntB: 

See Chapter Itf, cxpecielLy Pole 7 on pape L03. Fat an ^itanple 
UBln^ the technique described, asa ttie progEaiE on page l^l- 
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CIRCUIT SCHBUTIC : DISK II INTCRR&CE 
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CIRCUIT SCHEMATIC: DISK II ANALOG BCARD 
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DOS COMMANDS ^ 




ApreiDixF 





The DOS CDEMHAdB ate gtouped int<» 5 CAC«iCrl« la tbia appBDdtv; 



inn R£NAH£ 

CATALOG DELETE 

BAVZ LOOK 

RUN 



tfERlFT 



FP VKf 



{IPO 
CLOSE 

URTTE 



APPEND 
POSITION 



Rafldmif^Accifia TeiL Pile CQAMUdA 



OPEN 

CLOSE 



READ 
VfllTE 



ALGAD 



iTOcedurea u.^ed In DDS tlncludlfig chdinlitft 111 ApplAboft) are aunnnar 1 zed in 
A])p«ndii[ G» The notOtJon uftfid Id the aunDBfles (and tbrQu^tiDLit the 
manual) is desizTlbed Ifl thfl fcllowiTi^ aectidn^ 



NOUnON 

S^nia^ refera tc the structure Ci£ a COfflpuCUT CtuDmddd. A dlDpFE] ndtdtifin 
la used tci d«BCrtb{> the ETntax oE each DOS CDnand. 

Xz^n Ln Square brackets^ | ^nd ] , 4rc Cpticpnul- Thi^M ICfrnUt art- 
fioDEtlDea cialled paraneterB- FfoE all touAdTtda pi-mlc all parameters^ buL 
tho^e parameEers that are permitted in ^ given CDmiand may appear in any 
□ rder^ unleaa otll^ruiat il^ttd* 

tf □ CDmnand uafis a file naine^ the file nEune must ccrne ImmediateEy after 
th& CDffllund VOtd itaelf: the first Item foljew^rig thi> copnund ul LI bo 
trrated aa a file nafnt^i Th? file name nuaL be aeparated by a cninms froH 
an^ parElbeter that EdIIdus^ 

Curly bracketa luy be used to Indicate when a certain key ahGuld be 
p reaped I 

4LTHL> hold dPVn tbE key marked '^CITlL" utille another key la typed* 
{CTVDIf mcaneJ hold dovn tbe CTItL hey while you typp the 
letter [>- Simftini^S anothAr notation is naed: CTRL-D wana 
the aaiue be ^CFRL^D. 



m 



(HETUBN) press the lti?y Mrhed "RETUBK"- Thti IRCTUM} required 
after ^vi-ty comand not sbtlVn* 

fUESFT) presB the Itcy ■arkecT ^^RESET"* 

<ESO> press the ktfy tnarfced "ESC"* 



CAI^ITAL letter^ ^nd cooEiaa mist be typed A% flbdWUp louer caae Letters 
Btdnd Eor IteH that ynu must suppLy- 

f flJc njD6* This is from one to 39 charact^ri^ Jbiy typeabl^ 

character except thb coama may appear in a file none- The 
Elrfic charsdter must be A letter nf the alphabet- for mor% 
det^lL^lt S«« the nBEt Aection^ 
Enamples: CHESS 
EECTtE 

5VH OF SQUAKES 

HQW^AB0UT*THIS 

£ another flLft name. 

EKaqplc! SEPARATOR WITH LOV VELOCirV 

a alot rtumbcr* s specifies the Apple IT *lot In vhlch tht 

disk cf^ntrdllDr csrd baa been plaeed tuaually alat 6]. 
a inltlaJl> dtfa^lCb to the aluL from which DOS uas booted^ 
It Subsequently defaulta to the Iflqt uiilue Qp^clTled EOT this 
paraDEter. a nust be ill ch« rattgo I through 7. 
EiaEoplEaF 7 




if s refers to A t^Lot ^ich does not contain a dink controller 
card^ th« systea may step ^nd a prograu In Aeaidry Uy aven 
be lo&t- S*a T/O ESSOR^ Ip Appendix Eor more d^tallSp 

V vulune numb*r tif a diskette- v tfiltlally defaults to th* 

volume number of thfj diskette from iriilch th4 systcn was bootedp 
It Subsequently defaults to tht Latest vslue speclEled for 
this par^Tnett'r, or impllciltly specified by a CAIALOC cummsndh 
V must be in rbc rsage t through Z54' 
Example: 101 

Note; A dlAkctCti^ll l^cilume number may nut be 9* In a DCS 

cdmMndt sp^cifyine a vulune number of ar simply V 
Vith no number ia a 'Vild card" and tells tha DD5 tu 
determine Jind u*t the volune nuniber on the diskette^ 

d drive number (vlth«r 1 or 2)w d initially defaults to jzui^w 

It aubBCquently defaulta to the latent v^lqe apeclfied for 
this paramarar. 
E^onplci 2 
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P position iiuBbcr. Used with Che B par»eL» In tbe POSITIOK 

ud £XtC cmnBands for sequent Id 1 C«Xt fil4B- p specif ^es 
a field whose poEltlon In tbe file is p fields dhCAd af th« 
{zurrenL file poBltioo. p defaults CD which do^a not move 
tht f lLs-p09tllcin prtinttr in the £lLe- Bote: EXEC fllways Sets 
ch? pointer ttr cKe Stare of cht Tinned file, bd p is dLvay^ 
relative Lo when used Witti fXEC- Se« cownanil suHnnariea Idtcr 
In thiB Appeodix. p muBt be id ch« range t through 3276^. 

r recurd number^ L^Sed with tlic K pfrwneter In the KEAD Add 

VRITE camucid? f?r racidom-Bcceas text fileJ- r defaults 
tD i after OFEH, Thereafter, it doEault^ C4 the last record 
■ peclfledF r points tci ^n jshaalute reciord Within d rnr^ElDD- 
dCc«SS file. c Dudt bd In tht rdd^e S through 3Z767. 

a dddresm In iLAh- The a parftiaeter ia requirEd with tho ESAVE 

cummand- a ^pcclflea the st^rtinR Apple meaiory ^ddrets £or 
BSAV^lng or BLOADln^ binary inf DrBatioEi . If BLOAD dc>ea not 
Bpeclfy an a parameter^ then the vdlu« of ^ jJeEaultB to 
th«t U0«d ulitfi the binary flJe vaa BBAVEd^ a luust be In 
the range thrc^uKh 

b byte TuiBber- b defaults to In d sequential Etle, b 

points tQ an abaolute byte vithLn Z.h^ file- In a random-nc C cdA 
file, b polntB to an abBoiute hyt* within th& renord pOirttJ?d 
to by r - h qdfic be in the range to 327&7- For most 
Application? b ia in Che rdnfip throHRh the laBt byte in 
the current S^qudHtial file or the last byte in the current 
ra ad DUk- bc ces b records 

i leDflth apecifier- j dtfdultfl tP L- Hben urifrd in the OPEN 

CMmand with tandotd-accesa flJea, J ia teqalTCd snd apecilics 
the Eiunther of bytes that will crmAtitutC a record in a tdndmi- 
accea^ fiJe- Whef^ used with tbe USAVE ccHwndi 1 ia required 
and specifies the nuDbet oC b^'te? oE Apple TDemOtrp staTtlng at 
AddT4iSS A , whose COdcenta are to be atored on dlslt^ttE. J 
must bt in the raitR^ thrnugh 22767. 



A3 an cKBmplfi of Lhi& npCtElODi tbe DOS conand thftt is nptated 
WIT f (>VvJ [,Ba] l.Ddl 
can be interpreted bb 
HfllT HELLO, VI7, D2 

tj tbe following process- Tht Veyword "IBIT^ ia Id upper case^ and muat 
be typed e^^acrly as ahovn^ In the ayntdx dtSCT Jptinn , "f" ia LcWrr ca^^ 
^nd Btands for a file name — it ia replaced bf the legltlBate Eile d4m« 
"HELLO^ in this examplt. The '',VI7" [a optional. "V" SEdTids fcr 
■Siolume"; 17 was choaen arbitrarily As a VClmftfr niinber fcr thta eiainplr- 
The notation ",Sa" is opti&ilfll ddd onUteJ. The notation ",Dd" hecones , 
DZ in this eKanplep indicating that dlqh drive nuflber 2 In to be uaed. 

Any nunertcal constant In a DOS connuand can bci entered In hevadecindl 
notation by ptttdftdldi^ the heKadecimal digits with a dollar sign. 



ISO 



nii NAMES 



Fl Id daaoB nny be up to 19 characters long^ and nmvt begin wLth a letter. 

TUt* ddtw- cannot c^odc^in a ccrmmd, a CTPL-H or a RE7Ufll4, which la used to 

tfrmlndl-^ thr coamand^ i^pateA chdi prctode ch^ Eirsc d^ri-spd^ce character 

d dafBt Atd Ignored. All naide chatdCtetB beyond the 30th dte igni>r«d» 

X 

Ifhen typing file nawa, the use of social kays atich aa BSC. the 
lelt-arrow and right-arrow hey^h afld certain VeyB typed with the CTHL key 
("control" characters CTRL-C, CTRL-E> Uy have unexpected AfFectS^ 

If A tii^ naae dontalda codttul nhatacterB^ you won't aee them printed^ 
but they okiat he t}rped to uae OT delete the file- 

Tlie fonovidg Applaaoft progiau can b* itaed to flad any hidden chjiracterv 
except fKITUBH), ESC» CTTlL-N lUEt arrow) and CTRL^^U <rl(ibt arrw). 

= ii 

:^ 

Hp 



1 
J 

If you auBpect yflU BSy have accJdentallT Introduced a control eharacter 
tflto ft (lie bbH. type thia progFdk. SAVE it. and tUN It- The Applesoft 

pToapt ( 1 > will be displayed. HMt type 

CATALOC 

and fnu'^]] get a liat of all the files^ with any control characters ahown 
EK flaahlng f^haractcrrs- C^nrrol characcerB lev proi^ran Itstin^d C4n aleo 
he f{iund th^a way . To re^inst;ate normal printout a, type 



HOUSBCmNG COMMANDS 



INTT f I.Vvl |,Bb] J,DdJ 
KHHBplfh] IHIT HELLO, VIA 

1'hp puravettr V asalxns d vuIua^ number lo the diakette being initialiEed. 
l^t'Mlls 4>d InltlalLsIng diskettes are In Chapter ? and Appendix 



151 



CATALOG [,SflJ i.DdJ 
Eumpla : CATALOG 

Displays Ou the scma the VdIuh nunlieT aod a list at all fileE en the 
dls^tte in ttie ApfclFlQd ax d^f^uit drive- The default ^JoLune nunber is 
changed notch that of the indicated dlakettev II thla coamand uaea a 
valune pqrajqeter TiVvJ that pArOfHtcr Ift I^^cr^d- 

Uith BB€h EilE Id dlAplnyed an loElicBtdt of lea file type and che outnhdr ctf 
dltikeiite sectora ciccupi^d hy Lhfe IllC' The typea Are; 

I IntBger BASIC progrem Iil#. cnaCtd by SAVE- 

A AppIeaoEt BA.^IC progiMn fll4» creAted by 

T Tnt (ile. cr«d»d by OPRM aod tllUd by WITE* 

B Ainary menry-iBB^ Filep ttBdCdd hf BBJlVL* 

An ut*rl«V b»Jde « fUc's type IndtcAtor ahow? that the file la LOCKed. 

A mvlBUvn dlBbattt sectOTA Are available to the uaer* Each dlaVtcte 

ftficcai: fdh store up to 256 bytee of Infonatlcm- The fniEilqufp tengt^ af 4 

(lie I ^ect^Tp for an empty text file. [Technically, that I Betttcir Es 

OC^ufled by the »pty track/aectcr LIbL for the Ille-> ^Qipcy Tnteger 

BASICi AppleaoFLj and Kat^lae Lan^Ljaee files take ? tfectcrB-. <l for the 

trsck/aectcr Hat and I for the first pro^raa sectorp vhich cc^ntalna thti 

pro^u'a length. See Appendix C Icir ddT? dstalls-1 

If ad lodlvidual file «c«eda 255 s«c^tcra. thtt e^ATALOG display cf thAC 
Flle'e length starts over at ttt^ ThiA d^CS nOE dCEect use of the Elle» 
bat ttiy give aa erronocua iBpresaLcn hn Eull the diakettft is* 



BAVJC f .l>Se] r.DdT (►VvJ 
Kumple: SAVE COLOR DEMOS, V56 

If there la no file vith the specilfled File name on the diskette In the 

■ peclfl«d ar i^feulc drfvoj s file le created tm chat dlakncte dud the 
current: Tnte^r BASIC or Appleecft proyrjin is stored under the ^Iv^n Elle 
aaM- IE th# diskttte cc?nEalns a Elltr vith the api^clEldd file itafoe^ bat 
of a different laTi^uane or file type, then the neaaaj^e 
FILE TYPE MISHATOa 
vill be dlepleyed^ 




Jf the choaea diskette sl»ftdy contatw file with the Specified file 
nann^ and In tht^ Same ladeuAH4!» the crlRlEial File's ccmtientd are IdSt and 

the current OASIG prnguam is Saved in ItV place. Un varnlng is glvanF 



l.r>An F t.Snl IJhIl [.Vv) 



KiTPihplrl l.fAn JDF3ES* Vl?, D[ 

At r rtnpt » tT> I Ind Integer BABIC nr Applesdf t prcigrdi^ f lis with nav fen the 

dlllkrrttIN In the apeclfl^d or default drive- If the Vnluvne TiLEtnbtr^ nCch end 
thttrv Is such n flle^ thai, pr^prafn will he LflMlod into the conputer. It dan 

then hf> LISTrdt or SUTI* f^AVFJ aa with eny pragrani. LOAD closes any tipen 

text iJLoH, chanj^es the Apple to the correct languaj^c for F lit f , and 

rr*t*h any pr^^F^^b In nicjtipry teFore pl*K;lnR the naw prcRrani In the Apple. 

If file f fa an Applesoft BASIC progranip and Applesoft 15 not Ellrrad]^ id 
tTWTwry or available Ftoid the AppLeaoft Finsusra RDM card, the ptngran 

Appl^i^r>rt vlll bv Lf^td and RUH froTn the sp«e]E]«d drive sucop«ricaIIy> 
hefure f[l<i F la LOADcd. IE AppXeanft la not on thet diskette OOT on thp 
finware Bttf rqrd, the nevaa^ 
LANflCACE NOT AVAILABLE 
vlll h« dlspLiyodF 

The InfitmctloD LCAD» wtthout any parameterSf ulLl LOAD 4 prnflr^p fron 
t4isnect« tape- 



^im F r.Bs] t^M] [,Vu] 
KwnpU; RUN AHTOrm , D2 

LOADa file t from the ap(!clfled or d4rEaulL drive fBi4 the pr«vlouB 
dlncuPs|oia)i th™ HJao RUNa the proaran loaded. IF Just 

la typed, chn prosran In Benory la auH* 



RENAHE f, 1,3ft] |,W1 |,V^1 

Eqnnplet REHAFfE !1KFETLAT^. SEPARATE, S4, Dl , Vp 

f inds E^e File noied f on tht! diskcdts En Che spetiFIad or deEauIt drlvti. 
end changes Its namt to ft - The file's contents are not afEected^ If file 
r was open. It cIciSAIp 

X 

Jt^THMtl doe3 not check to see whether the file nane g la already In U4e, 
an It 14 po«»lble to uae RKDiAKH to put aeveral files c^f Lho awe naeie QfltO 

a ditfkrtte^ — a potentially cortEuftlnft flltuetlon* at best. 
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DELETE £ [,Se] f , VvT 



Exanplf: PELETE TE^T 

F^bDVcB the file rtdflwd f froa the dI?V«tEe In the Specified or defsuJt 
drlvCF It t was open, thlb CDinDdnd clcaea itij Se£ Apper^dtx C for T&orL' 
liet^JLfl ot ch* deletion proceQA* 

If a file Tianed f doei not Bjclat oo the dlsbctte^ the nieEBage 
FILE HOT FOUWD 

Vlll teault. Tp AVCld this ocicurreDcze atopplrR yaur pr^^r^ttS, Eint OPEN 
the flle^ Eiheft DELETE It- 

LJ1C( f |,Sh| r^Dd] I.W] 
EjiamplE: LOCK LOVE LHTTETiS, 

This eo^iiBBad allljHdp you tD make file f , on tb« dt«k«ttc in the spectfJ-ed 
Dr defnult drlvc^ ^a{b from accidental deletlcR or chanse^ A LOCFed file 
la indicated In the hy an astEriak ( * )* 



UKLOCR f I, Sal [,W] J.Vv] 
Eumple: UHLOCi: HECIPES* V3I, 

l£ jDU chqfige yo^ar Tniod, and itenL to alter nr remove a LOCITed file naned 
f . on the diEkette lik chb ap4C£fied ot default drivei tht9 covtmuu^ ellE^ 
fluth d chAnge- 



VEBirV ( [.S*J |,Dd[ |,Vvl 
Examples VERJFlf SAH 

FerfoTU a cherh that che InEormatiDn actually qCoTfd on t>ie diskette in 
tile f la aelt-CCinei«C«nt * ^Technically p thla ia what happens: When 
tht file is created ^ with SAVE, BSAre or Vtltt — DOS CilcuJdte* A 
Checlc^um byc« Eor the contenta of tach output buffer and then atocBa that 
fcyte irlth the huffer^s ccntetitf Ifi a nJUkeCte sector- The VFHIFT comnand 
44L<2Ul4LCb d nev chechaum byte for the actual contEnta of each file 
«ector^ and coapAT^a It with th* chcckPub hyt* orlg^njiJly stored vj.th that 
■ectar-> IF a file VEfllFVa^ no ne^sftge Ifl Hlven: it'^ safe to aaskiH the 
IpEornatian on the disV:vtte tide been atored correctl?. If a file does not 
V£ainr, the Muge 

I/O ^ROV 

in preaent«d* You may VERIFY any type uf file- 



U4 



WH [<)\ t*1l 1,0] 



KKflnpUnt WW 

All diah rfiHinqda flnd All tnEoTBUtlon fi«iiL batv«Qa cho cobpuccr jod the 
diak Jirci nanially dot dLaplayod on the at^teen. This coamand allolra you 
to Pfiahle auflie C^r all Chf thie display — a helpful tool uhan debugging a 
pVofiraH. IF C ia apecified then dlak CMmdUda are dlapleyed- If I 
La npPclMed, than Infnraation bElog sent ffoa Ehd dlak CO the Apple^ 
Applf^a Xjyput t vJll be dlaplAyed. If Is apecified, then InfOTnatlon 
h«in| aeat to the djak fron the Apple^ be Applets output , wllL be 
dlBp|«yL-d. 

At Lbdat onv of the three par^Hter^ nuat be preaent, or HON ia ignored* 

Tlie pacaoctorB nay appear in any order^ saparated by coamaBi These 
parabrtPfS appear only in the comnandB MON and ITOHOU* 

hntTTF HOfJ reoalrui In effect until a IfflKON conpjand^ a rhanne of language 
iVf T>r tHT)t a bo&t. or a restart (^|G>p Ivan RlrUnine a prograa wan't 
CAflcel a Mat, 



HUHOH ICl UO] 

E^rtpplea; NDMON C 

HDHQN I, C 

T>he ric^H cc^rutiFtnd cn^bCea you to diaplny disk cosBdndi^ dnd/or Inromatloa 
Bent betueefi the CMFpucer and ihe disk; such InEormatloFi ia not normally 
dla^layed on the screen- The HOUcHf COttftjifld Allout you to dloAble aoM or 
all nf thIe display. Thn conmand 

NOKON C, 1, □ 

raturnfi the eyaten Co lea uanalp default fitatfrp 

tt C ia apecified then dtak cnnaindi arc not dlepl^yed* If I la 
tpvcified» then Inforkdcian beine aent frciBi the diak tn the Appl^, aa 
j^pplv'a input , Vlll not be dlaplayed^ If ia cpecltied, than 
l4>f omatlOd being sent to the dlek ftom thv Applc^ dfl Apple'l output s 
vlll net dlvpldyed. 

Ai ieaat aoe of the three parameterB auat be preBent, of NO»Off il 
]||nprcdi The paraseterB may appear in any orders AepaTACed by cownaSk 
Thf?av pdtancterB appear only in chc CPPVnandB H0>] and ROHON. 



HAXFlUa n 

RuaBpl*! HAXFIt^S 6 

n in an Integer from ] to 16 that spacif lea the nuaber of f Ilea that can 
br arElvf dt one t ime » Uhan HAXFIL^B Ib executed^ 593 byt«i of mfftory 
0'NJl4d 41 tnp huFf^r^ aro reatrved for e*ch file. When you boot the 
ayatEH, n dcfaulta to 3^ ao that ynu vlll hdV6 t783 bytes raaerved for 
r]l# buffara and Mil b* allowed a mil! bub 3 filea open alnnlEdtmualy* 



M' DOS cowiandB Except Fnfp 114' and HAXPILBS require b Ille buffer^ Thus 
il yclu hdve HAXFTLEE U iind one file 1e OFEN, AO nttespt to peT^Drn [1 noS 
caifund (9tii;h CATALOG) vlll cauEe tKe wfEa^c 
ND BUFFERS AVAILABLE 
to lie dlAplAjed^ 




Ufle chf lUXriLtE Kivts niHEH- This cap Inteeer BASIC proArams at 

ApT>lefio£l: BtrlDRa. Uee HAXFILES bafojiE LDADing dud RtlrTnlng a pTOgram- 
Soc the dlsfZLifiEiDn in Choptera 5 dnd 7 if rUXFTLRS RUflt be uaed froiD 



ACCESS COMMANDS 



FP USh] I.Ddl UVvl 

ThlB {ZDsnnand put& yout BjStm Lfltc ApplCBOtC BAGIC^ Any iDteger BA^IC or 
Applesoft pragran in iDCDorj Ie Icati If your ccmpilter CDnt^ifis the 
ApplEscft firmware cerd, [X?S uStJI thflC source far tbie lenE^^E^- reeardlvriS 
of the Hifitcb pesition on tht tftrd- IE your fliHteiD does oot contain the 
Applesoft flruFvarE catd, ms etEE^mptS Lo load run the prograin neTucd 

APFLESOPT Ofl the dLsVeCte [n the specified or default dtEvt- 

Tf> place tbe APPLESOFT prDgteB QdtO d nawly tnlClall^ed diEk.eLte, flrbt 
LDAH the APPIF^^FT progr^P Erom the Haster VldkbttA, than (wlthaut aUKnlng 
nr LlSTina the f±Ie> SAVE APPLESOfT On dH Lntt tallied dialcette. You muflt 
ate the oame APFLE50ET fot this IlLe> 

Dd ^Dt uae RUn APPLESCTT to thdHftt iMRUSS^s- EverythidB ItiOks tine Qt 
fl»t^ b^i iKJa lia^ fiot properly initialized thtr Idn^A^e- To avoid the 
rWill:apt HSQ, Blwayn ufie FP* 



1ST 

Eianple: TBI 

Thia connand puts the Appt« IrtCO TfltejieT EASIC. Any Integer BA&IC er 
AppIesoEt prograin In nemory ia lorit ■ 



CTRL-D ( alac. writteri iCTItL>& ) 

ExampiEE 19 DS-cnnSlO 

29 PRIST Ws'VBITE CHESS" 
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Fvory tharactct PHINTed out hy tho Apple 1b firat AXdPik^ed hy DOE befdrt 
It Jb AtmC on tfl the outaide world, tF the Apple FRIEITff out a nETTJRN 
Chrt»ccer (nast PRIST Etatennta automatically end with a RETimn>, Ar\d i.he 
iwrJit tharof^cer Id d CTRL-P, th1« la » Maaage to DOB that Jubaj^quent 
charatittrirs (until the MXt KETURN> are a DOB ctpnMAnd- Haat DOS cocmandE 
Hwiy be uve^ Iitdh Inalde an Integer BASIC cr AppIeaoEt prnftrElnF tti dP ac^ 
PnrHT a Etring conaidtlne cf CTRL-C FcillDwecl hy the d^BLre^ DOS comnaod- 

The recamieiided vay to do this la ta first create a dtrLng c<>ns i a t ing 
onty nf ft CTRL-ES, then to UEe EASIC dtatrHncn auch as shovn in rh« 

exaiq?lep WdtE the uBC dE CHRSUJ to create DS IthJs worfca only in 
Applesoft^ aincc the CHBJ function |s not ofEetred lo Tfltes^r BABICJ^ 
InBTHd, CTBLH^ could have been typdd Inside quotation marha to treate D$> 
but In this CS«e nn charafit^r ia Shomt betveen the quotation wrka^ 

Evoty cliaracter jl«nt Out by the Apple ia fitfit »«nlned By DOS beCore It 
Ifl paaBDd on CO thfr QUtBlde world* If th* Apple aenda out A RPTirPN 
character Imnc PRIM stet^mentB SutEMndC Lt^lliy end wiLh a RETOHH) ^ *l»d the 
next charaQter ia a CTSL-Dp this Ifl a BiRnal to IJUS that auhsequent 
characters (until iht next RETURHl are d JXJS comnandi A DOB LCntgiund frnm 
a prograio oiueL appr^dt lo S M^TMT atatenent whofie flrac ouput character IJI 
CTTRL'D and t^hcae outpuL 19 separated froin preceditt^ And frnn aucceedidg 
printed output hy RETURM'^s. FjJr dddltion^l i nt onna t ioa » Be4 "U»e qE MS 
from wlthiTi ft ProBtaia"p Id App^ndlK G- 



Eaample: FA# G 

Sends subpequent Apple output to the dtvice contralled Etom fllot ' ? « 
In&tead of EO the TV fltreen- The QonWHd 
PRf I 

returpE output to the TV acreen- Tf the cuDDdnd Ia c^eed froni inside 
prci^rdllil^. It muBt appear aE a FRlKTcd E>US ccnnand, aa shoVn helQv: 
it PRn CTBL^ 

19 PRIfiT DSj "FRf I" 

If no d4vic4 controller card Is inatalled lo alot ' a , the ay^cci^ uy 
^an^^ ddd yCFd'll have to preaa the REBtrt hey to recover 



1RI a 

tXdTnpltS INI h 

TdkeS 41lhfltqt><^nt Apple input from the device contrdlled frcnn slot t S , 
InBteftd of frnn th* Apple Iteyhaard- The comnand 
lUf 9 

r«9«ttt the ni^nul fceybonrd inpuc* IE the conand is used Frooi ioside 
pronrama, it VniSt dppeer fn a PRIRTdd COS comandp eB thofcfia below: 

10 ha-""*! b™ CTBL-D 

7fl PRINT D$5 "THI 1"* 

1^ nf> dc-vlee controller card in IdflCdlled in alot I a . Che syaten mdy 
"hanV and you ^ 11 hlM to preaa the R^ET Itey to recover - 
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CHAIM E IpSbI J^Dd] |.Vvl 



ExjuDplei CaftDT PAHT TWO, Ql p SJ^ T# 

Used from vLthln an TnCe^f^r BASIC prDHTBrn, It LoaJft dud tims the Tnt^ger 
BASIC pTDRrdtn TiBTDcd f on the d]9ki?tte in thE specified dr dt^faulc drive^ 
but do*S not clfiflr the values nf any vorlabletip This neana thqt prngran 

f can operate the re^uICB of the previous prof^rdn, and can leave dain 
for any fqllovlng prograni. VPu tdnnot CHAIN Applesoft ptrcigraiuB u&lng thiu 
cDKiand: Bd« the speciial proQedur« fof Applesoft |iragtuifi In Chapter L0 
Apptndiir G. 



SEQumriAL nxr nu commands 



OPEH f [,Sa] I.DdJ 
Ex^tDpln: OPEH SESAHEp D2 

AJLoc^tea a nemory bulfer nf 5^5 hytea Co the text £lle f * dnd pceparee 
Che aystea to write or read frcm che beainnlnft nf th« fitt^ ThlB 
co«nand Is u6ed i#±th the WRITE and READ coMianda to create 4nd TttrlclVc 
aequcntial tej^t filcft^ 

If there ia riQ file f on the dljtette Id the specified or default drlv?, 
fme ia created. If a file ildtitid f ia aLread}! OPEN, thid domnand firat 
CLQSE9 thsc (11b, before DI-BBlrtg the apeclfled flJe- 



CLOSB If] 

Kxanple; CLOSE VIHDIW 

If you wert tfRITElna> a CLOSE cauaea all reiMlrilrtS charactnra in the 
output part of thfl file huffer to he sent to the diBkette apecifled «hen 
that file vaa OpFNvdp CLOSE f deallQCdCcA the buffer aaaoctqted with the 
siequcntlal tejit fll^ f , if CLOSE la iiae4 ulcl^OuE a file name, all flPEN 
fllea will be closed^ with the eTtceptloci of the EXEC flld. {Tbere can 
only he Cno EJCEC file flPKN ac any Cine- Wh^n anttKct ia Inpllcitly 
OPENed, Chc bniatlng EXEC flit. If any, ia autoDut IcD J Jy clti&edl 

If a program la Interrupted by a CTRL-C whlJe a file ia OPEN» tl^S a 

UPOi Idea to type 

CLOSE 

to keep atiy data frnp balilg lost* 

File* that h^ve been alloc^ttd by an OPES atatejnent Eftuflt be CLOSEd. 
Failure to CLOSE a file rbat Waa OPENed flnd wrllCfin to (by a WRITEJ cun 
re^dlc in loaa of dftta- 



VH['Lt F [,libf 



Ki^artlpLL-: WRtTE. APORF.?!^ - DATA 

Alter i-hlH 4:oBinflndp PRIKT Btattneats send their output to the apeclfied 
file Lnatpad flf Che Apple'^a TV screen- With the Byte parameter, 
WHITF-Inn hefilTiB at the b-ch byt<i of the file laee Chapter 6, page &9)^ 
MH[TF- [a cancelled by the prinUrg of any DOS conu^lndr Pr by an INFIfT 
a[ar^^U[;F^t- The null DOS coituMnd fslinply PRINTins a CTBL-D) wJIL do- 
UniTE nniBt b4 luued Jfl defer red'BKAEruCin TQCide^ 

Aftar thJa command all Apple Output chftTnctera thpt vould notTiially be 
dfaplayed on the iCTecn ^re aept to the diskette Insiejid. Thia includeb 
IflPUT queat ion-Hark prottptflj error Bcaaagea, and other unwanted 
qh^ractere ■ 



HFrAD f [pBb] 

h'HHiUpLL-: READ SESAME 

AJter this conmandt inFlFT statements land GEt atatcmenta In Apple&t^ft) 
obta in their r^Bpon^^ characters from the apcc If iod B^q^cent ial text file 
Luataad tron the Apple'a keyboards Uith thv Ryte parameter, READlUft 
boglaa dt the b-th byte uf the £lle 4aee Chapt«ir patc« 69J^ 

TNPUT causes characters to be HEAP frcffl th« sequential fife C»nt] ti«ld at e 
tLme^ A field ciouaisca t^f f ron 1 to 3Z7b 7 charactera . ending with a 
ntTURM characiter. Hoi^evetp boCduBe of che limited capacities of dtrittBB 
and input/dutput burferaj it ia very difficult ZO flicre ^fld retrieve 
Helda o£ note than oherscters^ 

ItEAP ia cancelled by th< printing of any DOS comnaodF A null DOB coimnand 
ijuat PRINT a CTRL-Dl will cancel PF-AD, The REAU command mat be uflcd In 
deferred-execution node- 



iKJ'rf.Tm f |,Sb) fiDdl [pTvl 

Example: APF&HQ EfORI INTO 

cuirmand opena the specified t^KC file, but placsa the 
positlon-in--the-f IJe pointer to the end of the file- After thla 
rLTWtrtfldr the fiext character written Into the file will follow che 5agt 
Nfiifueiitially written character preaet^tly in the file* An APPENU muat be 
foLtowed by fl yaiTE to the file ol the Aai» name- (APPEMD muat not b« 
fuUwed by OPEN^ becauae OPEN will reset the pos itiOn-lrt-the-f 1 le pnintet 
hack to the file^a beeiDQia^-) 
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POSITIOtT dealB with a relative, not an obEolute, po^LClonp fllucfi ydu count 
fields forvprd Fron vherc you ^tc Id i±e file v^en Chs FOSITIOFI la 



EXEC t I, Hp] r.Snl [,Dd] [.VvJ 



imscdJace-neQutioD DDS EiaiTTTTiard> the conund will bA cmmtcd befcre the 
progt^A f^cmtinuefi. 



roSITlOT* f [,Rp] I ^ 

Etuimplet rOSlTIOn ADDRESS -l>ATJVr i277 ^ 

POStTIDK places the poaitian^la-the-f ile pointer at the baAlnains nf the p ^ 
p-th Eleld fallfwins th* (me you're ln« £ltld Ifl A atquence of 

Lztiaractera Hervituttd bj" d RETURN^ Suhsequent BEABfr or WKITEh vlll _ | 

pTc^cftcd [ran chdt point fn tbe file jfli 



POSlTIflll ACLliallp ttcdnE forvard tlirouah the COT^CfntS of the tile, *^ 
ch^TAct«T hy chdr^Ctcr. looking for tbe p-th RETURN chaTACCar* It then 

places th« {hOBldcrD-ln'tbie-Elle painter fit the Eirst byte followliig the |^ ^ 

P'th HbTURII Dbiaracter^ IF, Ln thlft S»dTch, tt finds any hyte In idlUh ne 
chatdCtet has ever been Etared^ tht Tnessd^ _ 
FVia Df DATA K- S 

la sjnien, HoTmdlly, thlb occurB when the p-th field ah&ad at the current 

pOAltion in the Ff.le Is beycprtd the file's laat entry^ jj^^ ^ 



Similar to AUHf escept that E 1a a tcKC (data) File contelning AASIC and flt^^HF 
DOS cpDnnncIa as thcy would be iaakjed fron the kcybCLArd* Thi4 allovs you 
ta set up files that can izDotrcl the Applet EHdch aa you vculd nDutrol the 
Apple yourself^ 

There can or\ly bt one EXEC conMnd In effect at B time- If the EXEC IJLe ». 
<:Dntain& the 1 Hn^d ££l t e-exei: u 1 1 CDDn^pid EIEC, thtt orlBlnBl EX£C File 1b ^K- ^ 

claaed and the nav £XEC tile la npenerf and exenucc^d. If EXEC haa GFEHed 4 
Elle^ the toiuoacd 
CLOSI 

Vlll not CLOSE the ffle being tXl^C'ed. When 4n EXRC E]]£ haa coavl^ted 

all Its coQinkaflda^ U CLOSE^d itself and atnpa.. If a Cllc bolog EXEC'ed ^13 
COntalrra a tOinmand to RUH any progrsn, FXEC walta patleatly until the 

progran enda. Then thd ntTtC csmand in the EJIEC fil# Is «KMiit«d* ^ ^ 



Hotrever, IE a proflra* Le rtnldlna vhlle an EXEC file i» Opm± aay IVPUT 
atatemeot In the pro^rBB vlll taVe the nevt field from th« EIFC fil« 80 

the response^ IgnoriOg che keyboard- Wnr&e yet, If th*C respooat^ is an Wm~ ^ 
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Jf you type CTHL-C to flCop an Applesoft pragr^m thiC 1ft cnTining while an ^ 
KX?C fill- 1« atlEC Dpen^ the reminlng couuoda in the EXEC file vtlJ 

usually not be executed- " 



If hpvc-LCy th« valtie of tha It purameter* a poaiciM-^n-the-flLe 

polfltttr iB placod at the beftinnlna of the p-th field In ^he Fila, afid KIEC 
vMI Htari cmtcUllnR Irnm this point In the Ell*P 

Afl with maiTIOH, the R parameter uaed with EXEC abould bs thouflht of aa 
thP W^'lntlvt-f leld pcattlon parameter- Hovever* unlik* POSITION, EJEC 
jj^waypt rmints flelda ttom the benlnnlna of your file, bd p Is aluaye 
rphatlvd to im Th« other patabtfCors uork. as ufluaL- 

If yc^O ^apeczlly th« V&lue af the R patsbttsr beyofid the end of the file 
y^Fit'U Rot an 

OF QATA 
■laVBaH^- 



RMIKm-ACCESS TEXT FtU COMMANDS 



OPEN f, LJ Ip&sI r^Dd] [,VvJ 
Exanplas OPEN 5ESAHE. 

flPEM qllocBtas a 5W-hyt fila buffer to the randon-acceaa te« file f ^ 

and aets the ra^^ord leofith to the ntinber of bytea specified by ] - The 

nuHb^r j Hiuat b* In the rafige 1 to 3276yi j defnulcs to l- 

OPVN iB uaed with Che lEAD and WRITE tOPMinda to create Afid retrleva 
taOdoHMCCeSB teit fllea- Wote that the L (LenethT pttraneter Is nOE 
optlonalf by defiTtltlDB, yoa WU&A apecify Che record lenftlh of a 
randm^Atcesv teM file-. Each time you use a particular rSrtdPB-sccesB 
tfrKt File, you H»t OPEN th* file with the SAM T- parametof value^ DOS 
then uflea that value to calculata the atattlng posltlQu of any specified 

If thiire is no file E, cnSo il created^ 



cu»sE in 

E»q]le± CLOSE BOOK 

II you were WRlTEing, a CLOSE cauaes all reTnoinlng chatsCttrs In the 
output part of the file buffet to be sent to the diskette in the drive 
that was aptclfled whea tht file wsa OFEHed- Cti>BE de-allocates the 
hoffer associated viCh the Csndoendccess tejit fll* F * it CLOSE ia U#ed 
without S file name, ail OPEH Files will be closedp With the exception of 
an eAEC file* IF any» 

If a proRran la Interrupted by a CTBL-C while a text file la OFEWp it's a 

ftdOd Idea to type 

Cl.lftE 

to keep fr^n loalng data* 
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nitB chmt have been AllQcated by an OPEN stBtenerLC Huat be CLOSEd- 
fdiEure to CWSE b fllE that VAS OPEHed and vrltCen EC (by a WITE> 
result in ICAs Df dEt£L. 



ExflBfplct WHITE AODSESS^DATA, B3 

Aft«t thlB atateto^t, PRINT st^tthenC* £end ttielr output CP ihe &pEcIElEd 
flJe Instead of to the Apple'a TV scr6«n« WHITE ±a g^nceJled by the 
^rintlDB of flny MS CMnaand^ or by an IWPUT CtrfflMnd- The dull DOS CDUintand 
(filjopir raiWTing A CTEL-nj will Atop a HHLTE with a ninioiuB of efforts 
WHITE CM be uaed ooly Id def erred-«X*£lit±Oii PftlHT at^tevntB- 

Th^ R (RoCf)rd> paraneteT CduBeA the VIITE tQ bc^in At the tirat byte of 
th< r-th reQordp whet^ each record COflttlns tht nunber of byteE, J , 
apeclfLcd by the L par^lrtter fiveo vlth OPEN. r dQfdUlcs CO 0* II 
Lhe B parasKtcr l£ apeclfied, the WTTE wilt bftftiti at the h-th byte of 
tbe r-th record In tbe Ille- 



After Ch* WRITE stAC^Tuent^ £^1 Apple output characters that would 
normally he d]«p]dyed on the aureen ATt sent to the dlslcecte IrFaiud^ 
This Includes INPUT questlan-aarlt pTOmptBp error naaaaeeB, and Othit 
unvanted charact^TQF 



READ f [,llt| I,BbJ 
Exddple: HEAD SE&AHE»R3, 

After thifi atatementp IMPUT statt^Tnecta (and QSJ ^taEtmtinta In Applesoft) 
obtslfl the±r response charaqterfl from the specified randOB-accsES Ceit 
flit loHtead of rc&m the Applets keyboard* IHPUT causey chdract^TB CO be 
READ fton the rand Ont-ac cess fl[e^& Current record, one field at A ttflttf- 

A field can be fr™ 1 CO 227b7 dharacterft^ Ending with a HETURV chsraccer- 
Bovever^ no reC4)rd ahi?uld bft note than j ch4ract«ra in length, where J 
ia the recard length ap«C±fled uheD the flit wa« OPEHadp 

The H {Hecord) pdraKter csusofl the HEAD to heain at the first byta cf the 
r-th recQrdp where each T^^C&rd cCmtalns the nuinher fl£ bj^Ci«. J . 
specified by the L parap^tcr given with OPEN. r dcfaulcs Ed 9, If 
the b parameter Is specified^ the HEAD will begin at the b-th byte of 
the r-th record Jn ih* lile^ 

HEAD la cancelled hy chc printing of my MS comand- A iwll KtS cnund 
(]ust PRINT a CTTRL-D) will cancel READ- 
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M ACHME-L ANOUAGE HLI COMMANDS 



HSAV£ f. Aa, f,Sal f pDd) [,Vv] 

EnilpJeB: B5AVE PICTURE, Alb^flA, hSl91 
EBAVE PICTURE, A94il00p LSlVWI 

Createa a file qamed f » and stotea th* CdHtentA cf a seeii^^ cb« 
APPLE II"! tDa»ry* Th* sagDaitt Is mpaclCied by the starting dddrd^B a » 
and the number of bycAS co be arored J w 

The exanples shown above store a hl^-resolutlon picCur*. from the second 
hl^ih-reaolLit inn picture area. They are opetatiC»ndlly IdentEcali the 
A«c{)nd txakpld Jtiftt UBCB heudectnal notdtlOn for ctie pATOineterB . 



BLOAD f KAal [ ,Dd] I.VvJ 

EwiwplMC BLDAD PICTURE, AHl^Z 
BLOAD PICTURE, AS^KS 

Jf a Is ncrt Pperlfted* then BLOAD placed cht ipeclfled file in Apple'a 
nemory beKlncing at the BtatttnB locattcm of the Benwry Area that uas 
orlftlnatly BBAVEd. If a is »peclFied^ then the data 1ft plated in 
Apple's fflcmary bettinning at address A - NotE that a aMchlfle-Lanfluafie 
progran laay no longer bo eK«cut^ble if ao m4Ved- 

Asaume thdt a d hlgh'-cesolutian graphics picture hsS bten BSflVEd on d 
diskette under th* flU nftnie PldTTHE, Then the first MSntpU shown abtve 
would place the picture intc the Elcftt high-f bdolution picture area, whicb 
Btarta at Hnorr locbtlcift (daclraal)- The second vxsnple is 

equivalent: the eddrfrAS Is shown In hexadecimal, eft indicated by the 
bblDTft the 2991- 




Either exaDple would clobber mf verslM of Appleaofc lhat [ft not in 
rtrnupre. 



BROH f l,Aal [pSsl f^DflT [pW] 
Example: BHUN SUFE^H, A»C0A. V73 

R].OADs the file f Into Apple'^A m«A]Ory be^lnnlFiE at location S - If th6 
A parameter la omittedp the filt IS BldCADed atarting aC che vane 
lociation from which it VdS B^AV^d- flnce BLOADed. Lhe flXe (vbich should 
be d bdCh^i1«-Lar^ua£e program) is Started by 9 nachlne-ldngliA&e Junp IJHF) 
to location a m 
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F DOS PROCEDURES 

^ 




lb6 1l»0V«riilA fran Accidental BESCTa 

\bb U»e DOS trOA wttlitn a Ftf^HTAft 

L67 Ct»tlilK lul B«trl<via£ ScquantlftL Text 'Uh 

Itt C^trc^illDB th* Afple via a S«qu«nt]«l Teat FlU 

in Copflnt 4 T«xt Fllfl 



166 



This appt-fldix {zontalns 5S>mMrlBfi of the hIa procedures In DOS- 

pccceduTii Is listed on tht preceedlrta contents pflfle, dlone with the pa^e 
□umbBr on which it app^ara- 

BOOTING DOS 

Replace "a" by the ajot nuttit In rtfch the dinlt controllar ±B lociEed- 
Ptompt To hoDE nos, 

] Appleaofl PPlSfl or INfe 

■ HanltDT BfCTRLJP 



INITIAUZING A DISKETH 

To IKITla|i£« ^ ftlflve (neury d^pendftiit) dlaketc^i 

1) Boot DQS 

2) liiAert a blank dlakette into the dla^ i^rive 

3) Typo In d greetloE praRrMi, 

]0 P?-r«T "m SLAVF DISKtTTF- rN|TlALtZEI> 5 MAY flfl" 

Erm 

4) Aafiumirtg chooaE to naine tk-j irfeetlDg pro^rani '^HErnLn", 
type the CCtalsnd 

IHIT HELUl 

^1 After th« In use light on che dfak drive ^oes i^uC, remve 
the dlakatt* Aivd Ubel tt* 

To make a rnaatcr dUltttte, use the KASTRH CREATE pro^ran, pdee AA. 



RECOVERING FROM ACCIDENTAL RESETS 

If POS hat haen haati^il Elnd dKan chs RESRT hoy id aC c tde u tal Ly preSBAd. type 
3D0C 

(thAt's Chu nuwral lero j£t#r the D) to S^t back Into the BASIC you left 
with yqur prOfirsm fntaczt- 



USE OF DOS FROM WITHIN A PROGRAM 

DOS coranauda oiny be Ur^Uc^d trora within f) pri^^rMi by FBINTIhr CT«L-fl then 
the ccpmmand- First create fl setting n& which cona]qca flulj nf CTRL-0, 

In Appleaoftr D5 n,*y he treated hy Lhp command 

alnce CTFlL-D la the character who^e ASCII dude iti 4. 



In elUier RASTCp DS may be deClnfd b>r typing 
D9 - " 

then holding down the CTPL tey while typing the letter ft, and then typing 
ihM closLnfi c^ote- Control charactefC iuch CTELL-^D aren^t dlsplayedj aO 
what you'll AbC !■ 
OS - ^ 

Thlfe ApplMott proBrn dl^plHyA tba CATALOG when HUN^ 

Only on* DOS cnHnd mty be ccntBined fn « slnsle PEIHT fitatement- The 
PKIVT Btateipent'a quoted contents flWSt hcftln with d CTBL-D attd end with 
the POS copmflTid- The CmL-D m&t be prersded hy a RfTUKTi (flWt 
autCKUit Ically at the end of mOAt PRINT a t a temente | - 

Thfr&e comndTidll eht^uln^ cmly he used In def trrcd'-exei;utiQU [Bode {tvfrm vlthla 
a pfrtErflnilp appe^TlnR after CTHL-D in PRTHT atatetteutl 
OPEN AFFFHfJ URITE P05lTItl>J 

The coonaanrfa THTT ^ud nfl>LFIhES are best uSrd only In imfedla te-«xecii tlun 
mode (not ttum Within pra£ran>« 

{}ther DOS cCrmmdnde rwvy be used either Itl rMnedlate-cjiCCiltion node, ot Eroin 
within a progtdTti where they appear atctr a CTHL-D In d PHIKT atatenent- 



CREAHNG A TURNKEY $V$TBi 

Tn make a dlflkolte thot Tuns a certain progmia each tliae the dl&lcette la 
booted — lo the exaoiplt W4 will uae the program COLOR QEHO — use the 
fc>]Eovlng p recced u re 7 

1) iT^TTieLUe a blank dlshettOp dSln^ the nane HELLO the 

gr&etln^ program. 
Z) PUee A dlalL containing the COLOR DGHO? progran In drive* 

40d type 

UlTW COLOR DEMOS 

□nee you're UClftEled the proflraa RDH& corrtctly, return 
CD SA^tC^ 

3> Put the nevly INITlall^ed dialcette IntCi pour drive type 
EAVE UtLLO 

to replace the old grepting prPH"" ^he CDLOf 
prngraniF 



CREATINO AND REIRIEVMG SCCWBITIAL TEXT HLES 

Uheu creating A Mquentlol te^ct file, an OPEN Itiuat precede a WRITE; ofice 
WRITE is executed, any oub3fi[[hent PRINT comnand^ aend oil chatfictflra to 
the dlakette^ CLdSE the Elle ^en you're done. A WRITE command Is 
Cflneelled by an INPTTT or thfe uae of any DOS cioHmand In A FRlffT ncetement 
— even ju^r pT^THTlne CTRL-D will do^ 



This AppUeoft prCKtam dteatea a Bequentlal td)Lt file ndoied EAHFLE whoBe 
flTBt thirteen fl«ldB CMtalit thr« strings and the Inte^Era I througTi 10: 
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OB- -flf^H SWPLf 


SO 


PRINT 


"UmTE SPtWE- 


«e 




■^I HO" PPJNT -^l TO" 




POINT 


■TFF JD Jtm DISK UE 00 




Fi^ J 


' I TO 


M 




J NEXT J 



110 mtft "CLOSE 5HHi>LE" 

If you OPEN A Elle xh^t ^InMdy *xl»fl W tbta HBITE tc you vlil 

overbite part of th* orijiirLtl tllm^ 

This ApplEEoft pragr^m retrl^tJt the file SAHPLE descirlbed ebiTve, one 
field fit a time. If you ulsh CO s«t whdt IB bcltig HEaJ? Iran th« dl»k, the 
comnand 
MDN I 

will caupe Input trom th« dink to b» dlspldy«d« 

1© w - cm* f*> ran CHB*<4> 

IS CTHL-4> 

:* PMHT f>*. '^iCEW SIMPLE^ 
« et. CI 

!S0 FDf* I 1 TO lei 

All OPES EiuSE precede b READ- Once a READ ia executed, any aubEequent 
ITl?UT stfltUDtiita 11n ApplttDfc^ GEta Also) obtain theli Te^pcms? 
characterB fron the di«kettft l»tead of fron the Apple'^B kerboard. CLOSE 
the file when you're don«» 

A READ ia csDcelled bj PKINTing CTBL-Dt uhather cr aat it's foLlDved b; b 
|Xj£ comund- 
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ADDMO DATA lO A SEQUmilAL TEXT FlU 



ThiH AppleaoEt progClB ldd» Che two attinaB "TEST I" flod ''A^] TTOW FOB TEST 
7" m the end of a BaquBnllHl t«J(t £ilt called SAMPLE. Each siring 1b fn 
an additional fleJd of the ELle. 

- ('En PTW-EW ?flWPt£ 

.■■PI p^iM? [)■- ■►BPIfE SlWtE- 
414 pPiNT "TEST 1" 
^ PRINT 'WiJ' ^BW roH f£5I 
Pt^I'it -CLOSE SWlf^" 

CONTIKHJJNG THE APPL£ VIA A SEMJINTIAL TEXT FILE 

Whcci PUH, ChiB AppLesaft prugraD cEeateB a IBVt tllv ntined DOIT izontslnlng 

Ihv cciBnppda 

LIST 2tt.5tf 

HUN HEL.LO 

CATALOG 

5,P if* = CHt* '^4^ ran CiTRL-P 

-.!> Pi^TNT I>«- "l*lTE W>IT- 

♦H PRINT "LIST ^PrSB" 

SB PRINT "Hj*!* Me_iC- 

tP PRIMT "CflTALM" 

70 PBJUT f-*r-CLtm t>tJlTi 

□net til* t*)lf file DOIT £« created, the comMnd 
tXfcC cmiT 

will cauAe the conmandt In the file miT to he executed one by one, Ju»t 

BB ft they'd been typed In from the kieyboBrd. 
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CREATING AND RETRIEVING RANDOM-ACCESS TEXT FIU5 



Thlfl AppleaaFt pEDgEHDi creBtBB » rttidot-fl Cf rBft IekI flls noned RA-FILt, 
whoae records are Dach W bytea langi Then It UhrTP^B C^C Siting "NAME 
Al^DkKSS" fDlCouetf by the t«card nuriiEr, Inta rEcorda 12 thrau^ 1^ ill the 
tile- In LlnEB 7# nnd flV, reeard mimhpc [3 Ie iJiangad Co conraln the 
B trine "DQS". 

^ pc^f' r < 1^ Ttf 

HEl-T I 

Thin AppIaaafC praprm Rf^S records \2 thcOugh 1^ of cbe racidnfn-nccoqB 
lEBt ElJe RA-riLE. NqCe IfiAt JHHr flmHC Specify each record heforc TtEjVUn^ 
|[ Til line 40. Line 6fl SMmlnEH Che Three lefElVflr characters oF Ch* 

[Tiput atrlnft AS, taken frnin each record. tl ctvaie three iJi a r^c C e LTfl 0C< 
"DOS", the ncqsap;? "KeCCHHf c WS OIAHCED." in PBlNTed, and Che search 
4:on[lTiuC4- 

Ei' P^irJT :-t, "OPEN KH-FIS-E, L3l5" 

;^ ^rai V * a^' 

^-^V'it "WtrOfrCi "MAS CHfW 
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COPYING A nxr FIL£ 



Hcvlnn B M5IC DT B binary prograoi file to another dl9^tcte 14 no problen! 
Jutt T^nAl> cr E^IhOAP lKc file's contentB Into fht Appl^, and then SAVE or 
BBAVE tliDBe contents h4Clt 4nt<p the ether diskette^ Reoeinber CO BpfltLfy 
the BtnttLng Addrepa and length pAtdTneters u^en uelnR th« CDflmdiid* 

The t;0PT proj^ronv allni/S you to bulk copy the ccmt^ts af one diltkctte onto 
mother- Jf any of the Eiled on the original diskette are protected Erop 
i^opyltiK, v°h»'lL j^t c^rrcir rwsad£4; 
I/O ERROR 
STOfP^ AT 32 

To copy a text FJlei or any ynpr&tectei file for that uttETp uae the FtD 
px^DKTBiD* The Cult list mctLdfU for uBln£ FID dTb In Appendix J- 

CHAINING IN APPLESOFT 

To n serlea of Applesoft prof^rema without eraalni; earlier values of 
varlablee and arrays use the folloving proQedute- 

SuppOBe TOU ulab pruE^™ PART ONE tn chain U th# prcrgraii PAlTf TUO« 
Firsts make sure the blnHry file CHAIN ifl OH cbA aoiM dlflkeCCC with th« 
progl-Ah PART TWO- ilt it isn't, use FlC to ciyy it nnCu th* right plACtO 
Thm almply irte^crt ch«»« tvo lines as the 
last two lintd to be c:&frcuEtd In Che PATt? OKE prosrvi 
PHIHT CHhS(4); "BLflAD CHAIH^ASSfl" 
CALL 52a"PART TVO" 

No space or other character may beCvcen tb« And the 
in th« CALL COmund^ 
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If JOU dmdy tiA\'p l1 DlBk Op^ratlnj^ System, ^tvd n-^n^ t.i^ir'.\'^ .1 v't-r^lon of 
nOS ttiQt nu Id L3 aectora^ <DOB or earLler], ycm vliL need to 

change tw M ifour didk coutnllfti: cud to updat* your-s^fftw to |A 

sec^cnrS' An; nntoa of DOB ecrll«r tbu rtluH 3*3vlLl nHd tq tx 

HOW TO INSTALL THE NEW PROMS 

TtH Dw dlflk cmtrallu PftGUi f^lMfr iw PUIta an ueta Disk II contnlUr 

inaUe the tbe «daA-<^Dim«itGr *^«I«ti** mt t>» r»r of Eli« hIa 

bodrd- In «nfr 4>r tur* alotj you vllL tind c^irda loh«Iled 'PJ?k II 
Interface' Cdtrd^ At tht tQp ^Jg?' M^ke sure the paver is offi RentO^ eec^h 
of theae contfoLler Qarda by graaping it at the top edge and B^ntlf 
TocklTiA it back ud fortb* Roaova tlift vibhoii c4bLaA Eeh udi CAtd* to 

Hold! m COnCfol^er card in nne handj IC ^Ide tovard yotip "fingers p^rtion^ 

don* Ton irill aee £our rowA of two iCft on the card- Find the 1«Et IC in 
th« ■ftciind Tov froB th« top* Ie ahould hm ucfc^d ^Fb" or 'S4I'^pl0*-)a^ 
(p«4ai7 n&t t c^yrl^t fttlckflrjp -md tba urd b«X«v It Bboitld b« 
wttk^a 'PROH Ffi'* ThU 43 tbA TC yoti vlll wrpldd^ vlcll nt» ttXM m> 

Now Eind the left IC In the bdttoiD rw« It should be tmrkAd ^341- 

04B^ jcx^ IposBlblj tAdtfr a copyright Btick4T>» and tlu card bclmr It 
■bould ba uarkad 'FROM FS^» ThU ta iha IC ^ ulll T^lac* vltb tb« hv 

TVSK FSA* 
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Nov look at tha nav nOb^ Tb« tHV HtCH FM ^ouU ba wk*d n 

'34l-M2e-n'p or b<ieh^ flitiKif FEEOM ahould be Bnfked "P^A" or '341- 
B0Z7-Kx'^ or batb« T« abould ba abla to find tb«a« wrklnB* vithout 
pflfllEK aff any atickara* If you can't find the Eniiffber^ at allh sae your 
daalar* 

How tbat you know where everything i«» you ara ready to raplace the aid 
PItOHa vlth ck3? tie^ Dnea* Set the controller card dcvn qti a tdhLc dud hold 
ic fltMly* UBlng the IC puller, gentJy remove FBOM Ffi from ica aocket^ You 
■wy find « traulBtor* uarkad ^(^3' on the nardp blockJ^ia tha IC pullar* If 

l«tlT bud It our of th« ny mtil it la ^pmlBBttly nrtlcal* 
Qntp t^a IG ttltli ihm. pvll^r^ and aantly rock It «t of 1(4 Mclwt- 

■oU nCM F«A, iiAEk4d *P6Ar « 'Mi-M3a-n\ ao that tC e««a tht a« nay 
aa tb« IGa « tba card» Th* l^r^* Tact4ii(vt«v mtcb alnnild ba m tSm ImtK 

Mde 44 y« faca tba card. (There nay bt a scull circular depfaaalon hi 
tha other end. If yw are not sure vhich end goe^ wh^re^ aak ytimr duln-> 
Huhlns sur* that *Ach pin llnea up iri-th Ua hQle, gently insert FIUH FtA 

iTitn eiocket P6« If the pins ara too wldaly »pr«Bd to 10 In uaUr* ym mtf 

crh bt^nd thEui In unLii they ara vartlcal* by pMblns cAim cnaftilly 

(gentlyO agalnat a tahle top* 

T<Ow r«DDve FROM F5 and replace It vlth PROH F9Ap Hlkad 'MA' '341-'#ffT* 
xv', Ju«t as you replaced F6 vith 

If you h*VB more than twg Diak II drlv^--^^ >0u Wi.ll need one controller card 
for eacb ttKh drlvaa* 3a^ of tbaaa eards iri.ll need the uv piCHg. Install 

tbW » yon Inatallad tba ftrat p^tt* 

MAimi DBK nmns 

NfhU ^onnft't each Disk It dclvB to Its connraLler card nod pLui CIh card 
inco Its slor. In dip oidcc i^ifjun in the table belov- Tha flnt drlm 
should gD In the first Li^cati on Ll!?Ced (slot by drive I ) ^ and aa forth ■ 
(iiiltj you have IngCfllLetf all yX't drlvt^. You will be uorklnq downward 
tcDB tlol 6, flllinE EiiBt tJiE drive I and tben tho Jilve 2 ■: L.nnt'n: t U r6 o£ 
each C0rd> Tilts will onsure thAl Ctit drlne trt In the ocat BrficlenC 
Loutlout nd vtll Idcehh Hn rBHidkllltir ^our 4]r«t«Bi pEofrna will 
00* try «■ UH drlna tlut «■ mt tbarit or £|i»n drlvu CMt an tfaac*. 

FlacHnc Of Ttiuk II Drlvas 



InBtallatlDa Slot Nd> Dilvt N». 

lit drliM ft I 

2Dd drln 6 1 

3rd (trln 3 1 

4ch drlvt 5 2 

Sch drlw 4 1 

Mb drin 4 3 



LatMl wh drln 'Dtm 1' 4t tKln 2', *■ ■pproprUca. 
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cTi^ck thmt all convectloiu ats ncun aad that ^wrrtUua hu b«« 
infitdllcd In ±tB proper pUct- PTeOM P5 of ea(± controll*r CMTi mtmld 
have been replaced by FPOH (Ti 1-332 7-kk1 ^ PROH F6 of «ACb contnlltr 

cdrd shouU hnt been repUced by FROl P6A C34l-0e28-nc)* A Dl4k II 
ribbon ubl* ^^vild b« planed into th« drin 1 coAM^r of auh Dl«k II 

WthCn you are Batlafied tbdt Ovcrytli Irtg L« iHtlil«tf pr<^«]y( r«U «U 
replace the Apple's ccver arid f^o cm to updatfl 7»r 13 ■«tor 

dlakettea to l6 acctnt^, nsd nfl HUFFIH^ 

USING DOS WITH THE LANGUAGE SYSTEM 

¥du can use DOS and botli JL^pIe^oft Int^gaT BASIC vlth tli« AppJl^^ 

Lanfiiiag-? Eyfttem InHtalled- Vou do not need the BASICS Dl*k«CCe th£a< 
To beftln a sc^rCoi" llOS .-^fier usln£ any larkRUfl^ Oti the LftfiaUB* SyitBB 

wMch usQS tK<- Pn-^ral Oper^itinj^ SySteffii follow tbeSt St«pAt 

[> Rs: iLiri- to ■^.■I'^f nny pri^iz.r^ir voil have been workiflB DB* DCliervlAftt It 
will be iTS-aett ffom mmcry wlit^ci y<iv beftin DOE- 

2> Oat Into the Ccmroand iTM-le of the Fasfcal nperflttTig SfafaK [ao thit you 
dim sfl« th* llae vhlch beglna with "Co«iTiandr"t, 

3) ltqhl««4 tt* dlakatt* 1t» yout Dttv* I Icon^cted to tb« coftEroller cttd 
In hl^Ht wiA^nd dl4Gl Mth tha DOG Syatam Hut« dl4katt«^ 

4) Type H ftor Haiti* Thl* vlU ^jmflff that dirt drlva t-j boot jwar Gystn 
TIaster disketct- 

Tour SysLem H*1^CH-r diskette will now lo^d either Applesoft or Integer BASIC 
— lAlchever Is NHT ^ilrf'rtdy ^vfllLabLe on your M^n boflrd — Into Che 
Storage apace avatlabln^ £^0 your L^nj^iiap^e Card- Lf you hflve a standard 
Apple Hp tlic Syitttn Mnater^ when booted, tftJL toad AppleaofL Intri ynnyr 
lanflUBRe Card* Lt yOu have an Apple IT FLuS, Tritefter BASIC will be 

loaded* In cltlnir coai;^ a neasase will appc^ir^ telllna you which RASIC ia 
b«liiJt lopded during thft booting of your Syftt^ft Haatdr* All of the DOS 
coMAdA will nov wotk in th^ oslna ud wrlttn^ of progruB in botb 

AppUan^t and Intagpr BASIC- 

To learn th« proc4dure lot *Wti^ TH)S aftn uaii« 4 UngiuSa ^Icta do«4 

hOT use the Faacal Op^rdtlng Sy9t«m» see the macuAl for that Ineua^e* 

With lh<- L^iTiftaafte System InstdHed, you can boot CftS upon turning Ofl ypor 
Appl&t with the SyM.H.-ri Master dlsketu- In Drive 1 . 

To return to another Language SyBt*Tn language froo DOS^ replace the Syat^^a 
nastcT In Drln I vlth the aUfCbp diBkntta for tfa«t Uthguaga^ Than t^pe 
FHfb «nd ^laaa RETURH^ 




SETTING UP A TURNKEY SYSTEM 



Uhen you Inaert a hOS 3*3 diskAtta In driw 1 and turn on tbm ponri jmt 
Appla Will rvA tb« BEL1X3 pro^raa on th^t dtvk«tt4i if It hu Id RCH Clw 
BASIC vhlch tha KQ.LO progm la vrlttan^ Tlut la^ aa Applt tl vlll tun 
• n Tntagar BABIC HELLO progratip an Appl« II ITlaa vfll ntt U Applapoft 
HELI#0 progTAU^ And att Apple II vlch the Applesoft Card or mi II Plv« 

with th« Intaser BASIC Card will run a HELLO program In aithar BASICi If 
you don^t hav* that BASIC in KOM* you will gat a 

PTTor Bpauga and cba proapl fnr thft BASIC It dou lum* 

If you have the Apple LpngMag« Sy^teu* things g«t d bit Kte conpllcated^ 
Without further Ada, you can run prograna In the BASIC In ROM^ hut before 
yon can uSe th« Other BASIC^ you muat Load It into the Language Card* The 
-ilmplost way to dci thi5 is to boot the UOS 3-1 System Haster DlAkettCp 
hrhich 1« provided with two prOgramSi HOjLO and APFLESOFTp that together 
mAkt a^r* that both BASICa ar« loaded vhen you boot DOS- HELLO^ wrltCn la 

J^lHoft for thn Appla II ttum^ londs Intaiar BASIC* AFFLBSDffTp nitt«n 
la lota^v BASIC Eu Kh« Appl^ 11^ 104d4 ^ifaiofc* Tnnr Hfl^l^io vtU nm 
tha a^r^riAba progran, ud Aftmurda bafaan aa if ±t had bntli BASICa Im 

RCH* Eou can dht Inatrt uj otbar 1M>S 3^3 dirtattai nd nm a^ pmtraB m 

ic- 

T f yoNj wi^h ruikr >] rfl sket t f th.-^ t wi]\ hoot on .-ill tystC^S t 

and load the Language Card K necessary, you cdn do It by copying tb« 

appropriate fllea onto Iti Here's how: 

I* Boot the DOS 3^3 Sygten Master Plekette- 

Z* UU> HELLO froii Cta ftyatCH HuG:«v^ tlitii imnt ■ UaA diakatta nnd 

1HIT HBLLO 

3« Hhan INIt la flniAhad^ ninaart tha Sy«EaB HaJicn, BBDN rttSTBK 
CRBATE and typa 
HBLU) 

^cn iuik*d For lh4 naw of <h4 gr*attn| progm^ Iuhtc dw bl*^ 
di*1»tt« rolff En do 4D kQT KA£TER CBUTB* 

4* ValDg FZDp ccpj th«« fllft* nto ront novly tnltJ^Uud diakattai 

AmcaopT 

inTBASlC 

FFBASIC 

i» Put my prograna eml athor files j™ nat Oft thi* dlaltette- M^e 
«VT« ^ h4v« at lo44t the follOHlTit flloti 
BBLLO 
APPLESC0T 
IHTUBIC 
FPBASIC 

Vhan ynu hoot thta dl^atta on u vlCh eh« Lm^ua^ CaH^ It vIlL 

Inad Chs LanBua^a: Card with tha BASIC not in BOH, ao that tha AppLa can 
ruB any prograa in althar USlC> 
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%[ hAV^c $. turnkey program you vant the Applfi to FUn vhflB It 1* tunud 

on, you Jo it by ctianAlng the HELLO and APPLESOFT proErMfl U tb*t SACh 

of tbera will Tkin your turnkey progtaiD (v^'ll c^H It TI1R?JtC^ IWn)- TW 
vlll £lQd It enHter to edit thebe ptosrand ±1 fOu tint BUN LQIDlfAp th« 
Vfl* tba 4S HHndf n that you en h« tVi« CISL^ Ib Hch 4idwddcd DOS 

Sent «£t^ tTw dlilHtH jou ben J4H mde Ia I to And dc* Cli« 

£olleiitii«i 

fi. niLCiCK RBLLO 

A# LLST It ^ IaA AC th« lut ftv llnu 

340 END 
251 Bm 

RDl "NO CAJU3 OR CAN'T TCTLOAT 

ll' PfEV '768) * TtIEK EMD 

FRINTi PklHT ^ ^LANGUAGE CARD CANWOT BE RELOADED": 

FBIWT [JNTIL THE SYSTEM L3 REBOOTED---" 

END 

Da tlw occeeup the line* vlLl b« vrAppid At 40 chanctsnl lun 
tta^r mrm 1irofc« *1a«iAbt« tot el«tl9< 

9> CMng* lhM« llA«a » tb^ lud u folloinr 
4 I4| OTTO 3M 
2S0 SIH 

260 EfH —NO CARD OR CA11 'T RELOAD 

tJf REM 

* l&t IF PEEK t?6a) - ft THEN 

2941 PRINT: VFITNr , .LANnUADE CASD CJ WOT M ULOUlfl}"! 

FRi^JT " wrn. TSir -system is re8UOTbIi<>>* 

tbt chAn^tf or AddAd an Hrktd with dsterlaka* The loVH CIH 

«tn^ d £a llu 3M E4prH4Als CTU.-D vhich vcn't Qbcw up h tha 
4«nH DT !■ a llatlns- Ifi dim'E Uk* Invlsibl* »at»l chuitcrv* 
-In rniT fll««i rw d«el*r4 4 atrlo^ DS coBtfltoliit a CTOM^i Aihidi 
w^ld luke line 310 iDak llk« tbii fin Applesoft): 

* 319 D5-CHR&14) : PRINT Mjldm tmHEET' 

If you do cha.9, mafcp sure you d«cljir« DS before you use It* 

T™ may fllatj wleJi to change or dt^ln-C-: ^Jim^^ oT ihf J'kJNT s c n t t^a^p n t q In 
the program, but make aure you leave the oO^j i4lth DOS CCifiUvand? 1tti«-ie 

Will bm CHL-D* l4i thaiL}^ 

1ft* SATE HELLO 
11. LOCK BELLO 



12- mum AfPLraOHp IAV it, ud list It^ loAlng 4t ttM laat tav 

llneB* 

2^ft GOTO 310 
2^9 REM 

27a RFM -'MO CATO OR CAN'T REL04D 

;8fl REM 

Zqft TF PKfiK (766) - I THEH 

^00 FFEINT "-"LANCUAGE CjUB) CAnUT BB mtUtOTt 

PRINT " It^TLI. THE StSTH IS feOOOtKB-*-* 
31(1 PPIWT "tcrl-dlHT** 



13* Chmgfi tbe«* Unaa to raad aa falloiift} 
2^ COTO 3t| 
26ft REM 

270 REM ^— NO CABT3 OB CAH't ItlLDU 

not 

* IF PEEK ilfiS) - THEr; 3ia 

3ft0 PRINT -LANCjUAGE CARD CANNOT BE RELOADED"*; 
PiJMT " nriL TIS STBTft IS BBBOOTED..-" 

* 314 mwt "Vtri-dfiDN TimttET'* 

Line 3lft c^n aIqo be put [n th« fotn 

* 318 D$-''ctrl-d"tFRINT D$3''RE]14 "nnUIKRV" 
to iuk« the CTRL-D «A4Ur to £Lnd + 

SAn AP?LJS0*T 
LOCK AFPIZSOrr 



REr44HB ycur tortdc^r pr<V»la TOEDOZT* A a^tla TOnOY ^oeru^ lo 

AppleaoEti balort 
Iftfi TEXT : HWE 

lia me 1: FEIHT 'TJOS TOOL FIT TiB( 3#) ("M mW 

12ft ITAB 5; PSIHT "(0) COPYHIGffC 19T5, iPPLI OOMPlReR IHC-" 

130 fOR I - r TO 1500: HEXT I 
140 PRINT "ctrl-dRUN HIBBIT" 

17- Hdke sure your diskette haa tha follovln^ EUm qq itf 
HELLO 
APPLESOFT 
INTBASIC 
rPBUIC 

IB- Hcrtr cast TOUT turnkey diskette by puttlfle It In drive 1 and 

tvntlng tJia povar off and on* It ahould boot DOS than load 

Inta^H B ASIC or ^^*o£t IF aeced^afy^ tban nm tl» pngrMm 
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HE BASICS DISKEHE 





Tbe "BASICS" dlBkeCt^ th^t cone vlth th^ •j^tOB HCt^r can be used tc 

hoot I3-Bectar dlBhett£s on y^^r ]b-S[H:C4>r tyAEen* TerBiDDB of D&S 
c4rllor th«n 3-3 ar^ l3-SfctoT DOS. 

Apples CQDie Id twn flayora: Appl« IT ifld *pplt II PLufi- Tbe Apple II has 

Intener BASIC In R^ad-Only H«iOrT fSOn) on the iBatn prtntEd-cl rcul t bo^ird. 
The Appl« It Plus haA Apple&nft. BASIC In ROM on the malri board. The 

lAn^U^ In ROM la Idnguaga che Apple vLlL come up In vbea It Ib tiirfi&J 

oni it it hmB ChC jJltk drives or accesaory carde. 

BOOnNG DISKEHES USING ''BASICS" 

Td use either Integer 4r Apf^losoft BASIC, Insert the '^SECS" disVette Into 
the drive, end turn the Apple on. In Kl»out fiv^ a^c^nd^ Che flCTQ4il uLll lay 

Inert any 13 sector T»OS/BASTC dJak^Cta pre^a HETTfaJI * The Apple will 

ncv behava bb described in thl» HAnudl i exC4pt that one atap ta added to Che 
boot IflC^rcup? ^TD^edure; 

Vhen JOu tun] the Apple onp dt typo Fftff6, C600Gp or 

«CrRL-P, the "BASICS" disbc^ttc hoit be In the drive, each tlK 
vant to baot A r:l aector DOS. 

Whan th« cu* coaicb art the 4cr«^i divert th« 13 B^ctor cns/BASIC dE^^ette yau 
wish boDt » IF ynu art In either BASIC and you typo PRI6 or IWlfi ^ yog 
Vlll h«^c to ivuiert "BASICS", then rtlnA^rt ymir prevlnia dlakett«* 

Once ydu bava DOS running* you can avitoh tzm one BASIC to rh^ otb*r by 
hislqg the IT4T and FP connanda notmaLl?. 

Ap llvsySh you can tell vhlnh BASIC yoii are In by ths pro^t you see oti Ehc 
3ct4«n! ^ fct ItLtt-gcr !BASlC di^d ] for Applescrft RA^lC- 

A dl akette de aigned for ^turnltey^ Dp era t Ion { tha t la^ one tha t at arts 
executing a program vhan booted> can be run as heFnre, aftsr the "BASICS" 
dlalcetta baa been mn- 

Ycu Cdn ribooc VlthOuC turning the pouer off. Simply Insert ^*BAS[i;S"h 

typt PRifb or 1Hf6 and preaa KE'mE!] t then cue tnaert 

diskette you viah to boetj- 
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FID PROGRAM 



JiH riiMawu nd UlIdCA 



rm (for tllA Omlop^x} flxt«4d» tlm 4iblllEl«4 of t6-««K4t DOS Ln two 
C;r^A df ftlffli SftCAfidi lb lati yoa copy fra dh dtcutCi to cn^tbtr 

FID nine M Apple with Applesoft^ JDt Of WTe of iwinoryp and OH 
HT« m«k II dTlvt?^ The Fin deAtlnAtlaa dtfl1t*tC4 (the Chile you wllL fr« 
copying to) ntiflt ISITlallHd ta ot4n tot ftJt t<$ wsHl*. 

STAimNG UP 

To use FIDt boot th-? COS Systen Master Dlakettep ttien type 
ZRW FID 

lou will Hft m llBt of COOHOdv oa the screen- Each of Khm. fian be 

meUlffiS «« mtlKMRD CHAMCIBB 

SOmfi of th# COTiirrld rid ^ r-ink y^M fi>r ^ ft lenam^ ^ The f lleTiane Is typed jufit 
a 9 Eor 4 nOS CO^invi c^^^ t ^ K^f^p t th.it ychU ran replace part of the f ilenBine 
vith the ^Vlldcard^^ cKafcracter { ' For exanple^ If you typed the 

£ll«lUiK 
FB-ni 

thm ptOgXBM VOUld ■«lftCt All the file^i ^oae nane^ bef^an vith ^FR' and 
Qi»dd vith ^Kb'* If ymi typ^d 

All f^t^A Unas CDiiLAfiHd 'M' vould b« g«Lected> If ymi typed 

all ttUm w thft dl*kett« miuid b« Kt«cc«l^ <"0a Mich dlak^tt^f^^ you 
iii|ht uk* Thii vlll b« «pIa£dh1 baln^) 

If jou ttHd a vlUcard charactar In a IllcnaiM vpcclEluCloiif yn vlll b« 
aflkad 

DO YDU UAHT PR0HFT1NQ7 

Tf you raply by ty^lns 
t 

roc T«p you be asked to verify *ach filenaB^ before It la adad on* 

If you WiC the ^Aii tha ayataa displmy^ It on the g^re^i typ^ 

IE you Ckm't Ant tb« flla^ typa 
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^ -I 

E i 
E -4 




IB licbu uia, rem vlll clua b« prciaptad mth tha iHt EllfrHHB vaCcfaln^ 

If yoa don't wuc tb* tll« or maj oC tha T«t» trfK 
(J 

Ud OV WTB FilVB Hill bfl ACtAd im. 

E f yav nply 

N 

ta ElH 'DO TOG U&HT FROHmnO?'. dll f ILab bBtchli« your 
■IMclflcatioii vlll IM Hlactad* 

COMMAIKff 

Hrast rtf the FID comAidnH^a — -CataJog, Spdct, Del&te, LdKzk, Unlock, and Verify— 

operate on one drlv^' tbie one last used , uri la as the dsf ault a are resets 
I'lhi' C^y\^y cnsfimand can Lisa ori^ drlv^ or tutiy as yoha vfsh. Thf^ l^u^ t COmvund 
i| riiht "90 tht drives^ it slnpLy L■K^c^ c^ll: progron, El^JvIre you in DOS* 

Ulit-E^ the pro^raB first cdhs upp no detauLt drive ViLl hd^P h^an ^^eta If 
your lirst cdnnnand is OM of the Cpne-drtv« ccmunds — Cdtdlogh Spa^e^ 
Delete, ]>[H:k^ and Unlook — you wi.ll b« protiiptad for a slot and drive 
nuAer^ Th»e will set tho defoult drive until tber 4re cton^d- if yw£ 
ttm coHUd la the Copy eoawAd* you bcr pronpEwl for tin a»t# of 

4loE mi 4tin mAon^ on for the hutco «d ne f« tbo dftatiucioft* 
Aur tlM yog wic^h ttom G^y Co a OK-drm cttnand^ dt vice nta*» you 
vlll bd a«k«d to ^McUy ooa or tH drtvoa^ With the Reset coMftnd* you 

ton eanc«I th^ dofAat alol nd drln m^ftrv «t any time* vhich itlll uua* 
riD t4 pronpt you for oev onea vhen It noeda theB^- 

Hotat Bako aure you give real aXot and drive nudieTA! If the Apple trle4 
tQ nad txcm or nlta to ■ iHiiaxi*t«iit drln. tbm pfOsTAai vlll «n4b- 



CAULOO 

3 

flv44 yoQ « cAtalog of cba dafaiilt dlafcoct«^ IE you luv« but teE Ibfr 
Multa^ you olli t» proapted Cor alot *nd dvtvo m^wa^ Duu choafc 
Mv« bMa aat^ All coamAudm vlll autOHtlcally ralor CO Chi* dtln* unlou 
Ch* daf ULC» Ku TeHt> 



RESET SLOT AND MM 

The Ke^et ^i^MUtd leCs ygy <4LueA tba 

type 
7 

This cdncals tha ourroot dafault slot 
gtv« 4 ccwnd that ragulroa «lot ami 
for TUa rnaiifiil fm convaulant 

auccaavloa* 



dafwlE stoE «4d (TriVA^ TO ua« Itt 

and drive miAtts* Ihv ant tlvB ydP 
drlvA fflrfldiarBr you vlll b« pro^tvd 
If you Hlah to CatAloi two drlna In 
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Kot^i Dm Buftt G]ac mnd Dr±« m—mJ shovld not b* coafund 'with 
ElM RE3ET fcg^^ Tlwr vlll alwTi te capltKlli4d dlffawtlj, to mid 



LOCK HUE 

andp uhen pri>mpt£-Jp nype the fiLsnaH* If you typ« u ionUd fllnsBap 

you vlLl be prcnpted until you give a V^liLd on^^ 

You uilL rinw ^e Jiaked to Insert the diskette c C^n t^i 1 fli rig this flla^ and 
askfed whether you wlah to EECape or proceed- li yo^ proceed and the file 
1« on the dlahett? ioBerted, it will be lockedt When you cdtdlog the 
dlftkettft^ the filen^ne will be preceded by an aftt^rlsk ^ * * Indicating 
tlut tlw J4 Locked- If th« til% la not on the dlAk«ttat you vllL tfit 

« no FIUS ag. TCm arnt jpon rKovar by pHicluc Uf tmj 

flXc^t USRi Bim, GTHLr at ESC* 

UNLOCK m£ 

To unlock a niSf typfr 
4 

and* ifaan ^nptSdp ^p* tlw f11ti^^ If yob u Ivnlld fUiBHar 
yon ttlll Irt votll you ^In m valid 

K^w vlU. BDV ba ulLad Co lu«rt tha dl«lntt« concaliilna thl^ file* «nd 
^akad nlMthar yini wiah Co ESCape or pncatd- If you proceed and the fll* 

1* « Hi* dliilt«t«fr tt viU b* tnOock^di Vbm yotr utUoA tlu dlskatUt 
tha flluM will DDE b* pracadid by an a«enl*k , * , indl«iLe£i« IbU tli* 
f ila 1« AM 1ckJ^< If tb4 fU4 1« «L tba dlAactCr ymi ndll a^t A n 
riUS SBLECIED aritw H4UBat yoa tm r4«av«r by pn^aliis uy bar 
RBSITt SHIFVt CTEL^ or ESG* 

VBHFV 

Th« ¥*Tify CC«tt4 1» Ili4 «a* U tb* DOS 7IRIFT coHnd« od 1iudl« til 
type* of f ll«i4 To UH Itt typa 

md «n« tb* pm^lo- WtOA 4 fllo hu b*H wrlf l«d^ cb« acran vlll 
dliiplty 1(4 lUM and tb« wrd 

If m rilo cu't ba rHd md It tin litrtlM* ^ vtll ^it n I/O EUm 
MtaagOt nd tha profraa will prc^t you to pnu « bay* Hhan yw do oo* 
yon vtll r«tan to Aa naln Hoa* 
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COPY FIL£ 

hiD I .in ro[^y f ilea 04 olthoT a aulcipla-^rlH or a aingla^rln iyttaa- To 

C.n[hy F 1 1 t^p^ 
] 

and you vill h* pT<mpt^4 for Source viot Ad drlvo utdftara, Ebao 
HaatLnatlon alot and drlw mmitua* 

If lb* tlot nd drlivo UiiAara mra diffacaat, tou b« a:ak*d for a 

f tl^aiUt vblcb can contain wildcard. chatacCar** Too »a »PT ^ vbola 

diJikttte by typing ■ In reappiwe to thlo ptoept* Af tet you have giveii tb* 
r Ll^ndb^» you w]]i ho aaked to Insert the appprnp^late dlftk^ttea and preSB 
filther ESC^ to fibort th* Copy^ or any key hut RESET, SFIFT^ CTRL, or ESC^ 
tiH y,o Ah^^w If th* ril«j you aabad (or are on the ^nMLrre dlqkectt-t and If 

I krr^ la enough roan f^r thou on the deatinatlon diskstte^ th^ you vill be 
h^fntlKd that your file has reached its new hone^ otbieTwife. you will gtt a 

^[^R trror manage* 

II the daatlnatlon diskette already contain^ a file with Chd iuh you 

you will lat tha BaHaga 

TI1.E 

TYPE IV m FILC WS fDI THE GOn Oft 
<KEIDBI> TO UrULGK rUSOR tUM CA 

<cm4'0<mmts> to cmcs. asn 

t 

It ycu ent^t a Fiew flleT^aA^f=» the fll? will be t rfm'nFnrrr'L'^^ .i^lI Adored QlldOt 

that net^ ndnK* If yod preas aETUSHt the old file will be replaced by tbo 
riew one^ If the aid flla la M>t lockad- If It 1«* yoa ulll a« 

FILE LOCKH)* 

BO mo wisa m mucE it junvu? 

If yott tyfta 
T 

tha fUa vlll ba r^lmccdl If yo? typa 
you vtll Ala aaaaaaa agalni 

riLE 

ALRFjWy EXISTS* 

TYPE JN HEU FILE HAHE FOR THE CDF1f OR 
<|lCimUi> TO miiACI PBtSBXT PILE OR 

<cnLM:><RETim> to cjhcbl con 

] 



ir* vh*n jDu 30P this meBBA^e* you press CTB|>-c nd ttm femnVi <h« fll* 
not copiAd* If no f[]ft0 vAr« rcninil to upft tb« pcDBirH prl^C 

VO FILES BB.ECIED 

If m tilm Coundi th4 progTM will prtut 

DONE 

Th*n 7DU vlll he pranptedt 

Hussa JVR EE! TO aniTiinn 

Sliul*-Drlv« Cqprina 

ir th« «p«diFl«4 Alot> Attd dTiv*9 for the flourc* and de^tln^tlan ar« tba 
«Hftp tlH propflB HU. yoa Hhtu to put t1i« vovrce and to pat thA 

d»t£iiaci» dl*k UtD tb« drlw^ Thu^ «dfi4« be ii*d« b«tnn 
diftkm vlth obLt dh driv«< 

DBinntE 

Thlft coTTiTTiand d-'ieiBB ■ flU H Ht of eiUa £tom tlw Jilsult diskacc*. 
To bfl* lt» Eype 

Tdu vlll ba JiBliVl 
FILENAME? 

Vhaa yoa typt cht ILi«iinK, tbe progfu ilXl try to dalat* tht uud 
Cile. tf Ml ftHi Mix* Tou «■ tlw ■■■■■■■ 

on the MFBH- IE tb* fil* coaid -not hm touaif fta vlll tba 
TO FILES 

If tli^ filf '^33 iDdkvrf, Sfou HtlL iit thsKHIIB 

FILE LOCKED 

mat eila m't bm dvlvGed- 

To'rBtnrn Ea tlw bhd, prvsa ■ lur oChu tbia REIUBH, ESC, Cni<i snmr or 
KBSET liiaa te* tlie |>r«ipt 

FREBB AIT or to COVTCHS 



SPACE ON DiSlffTTE 



ThLi: I .'TiirTh^n.r En^ib you find out tiov buj HC^on aiT* UHdp nd UBDHd* On 

iKe deioilt dUkatta- To uHe ic, ^pa 

3 

ud tbua mi^an will bv dlapl^d od t1i« «i-riaB. 



ThlB c«aad lets you nit tha pra$nii cleanly- Uan tdu typB 

JVB mil Bi* thi aav pfOf^C on tha screBq bb jvu bv bafon you ran FID. 



ERROR HANDUNG 

If th# program detects U irTKOW»b]« ftvnf. it wllL display an error 
MHiiflt ud abort tiift c|>««tfofii tC m. Copj opcrdtlon la ahf>rttd^ you 
should tstalQg th« d^stlnatlm d£«k*Ct« and delete any spurious ftle that 
uy have been treated by the operation- This apurlOLia file. If ±t exlftta, 
hive the naine of th& cfiginal flle^ or a new Eilenaae If you B^Vfl IC 

fpflFj but it will be short-^r than the orlflinal flit, as it wllL be 
i ncnmpi et e + 

^rror OEauagea are gcneratad for these errora: IJISK tULLp DISK HRITE 
?9ffaC£tD^ FILfi LOCKHft nd I/O ERftOEl^ If oE tb«a« occarai VXD Mill 

valt for ]rcu to jpr«u d k^r^ chn rtfitrft ym to tbm hI« 

If a M£ trror 4tl»r tbn on* i>f iheoe kcuh, Its ^mr i;i>dti n^ar wllL 

bt printed* Thf a mil luppu dd^ if ^ou ulot>b«r«d DOS, or tlobbvnd ITD* 

or triad to «vr a II of ^1444 tblnn hnpcnad. you abould 

rtbdOt DOS* and TaBVnR Pto- 

Tf 44 «rnt cnc« a spaf loma ril^ to bt placad on yodr da^ttirttloD 
dlak«tE4* d^lttt that fll* iHvdifttvlr. bafon copying any «char flla* Co 
tbt davtlHtton dlftk4l(«- 
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i9t VtUe-rd Cb«rwtean 




The cuTTQit I>OS 1b a "16 sector" DDS^ Earlier versions of DOf> mre ]] 

sector- For 4 dltcuealOTl of fitctota^ see the section entitled "Overview of 
the StoTBRa PTOcasa'^ In Appendix 

A. 16 saQtar DOS vill not vnrk vlth diakattea th^t have been INETIolf^C^d 
vT th a J 3 B^ctQT DOS* This Is because the Inf oriVtEon Is arranged 
differently on a 1^ aeQtor dlakette^ If you try to use 13 sector dislcettes 
^ith a 16 Aactor DOS, you^ll the nHSaase 

UHABLE TO READ/WITE 



STARTING UP 

The PItlFFLW ^rOgrOA COnWTtS 1^ sector dlskettea, and the prnsTflnfi they 
COntalHp to |6 sactori It d[>as thla by raarrAnging the InfotUtlotL dud 

then Vtitln^ it onto andthat diskette* Tha diskette It vtltea the 
information onto fthe "deStlndtiOn'^t buSC hflve baen IHTTlallied with a l6 
sector D05« After the Inf o tiu C i.0 fm th^ 0l4 dE^ketta (the "source") is 

converted onto the destination^ the 13 Sector version of It Will stllL 
eTlat on the source dUkctte- 

To ■avimiEft Ch« vnount Qf disM. space which is usable by this DOS, it^E b^bt 

ta CQQVert aJ-l your H aeator filea tu a i6 fiector diskette and than re* 
IHITiallEe the old dlakettas 4rLth the current DOS- 

The HUFFIH prug^^ vill vorV ^th either one or tVo diak dtlvtflF 

Thlv eMinpl« 4havs hov 49e hfUFPTH to convert fLitA Cram a 11 aectdr 
diskette onto a 16 aactor didkecttp On dn Apple vlth one dtfih drlva- It 
aaauKa your d^sk drive ia connected to the controller card in alot 

1) Place the SyatoD Haater diahette in your drive and typO 
BRUB MUFFIH 

2) Uhm the MSBd^a 

* APPLE I DOS 3 £ TO 3 5 COHVERTEE * 

m * 

« HUFFIH VERSION f> ■ 

* « 

* COFVCIOHT 3979 APPLE COr*TJTE» INC * 

CHOOSE OfC OF THE FOLLOUINQ OPTIOHS 

Cl> CONWEOT fliSS 

<2> OUIT 
MHICH MOUJ> von Llt^ 

uppearsi type 
1 

to IndlCAtS thdC you ^sh to convert TileS* 
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'i) Nov ynu^ll aeS tlit question 
SOURCE SLOT? 

Type b (the number of the alot your diak cOncroller Cflrd Is In)* To tba 
ndxt qE^9tEi?nr DEilVE? respond with I- 

a Uhan yov s«e 

DESTINATION 3L[>T? 

type 6^ and th&n dn^uer the question DBTVTJ by typing I, 

5> Now you'll be asked tor the name of the file to bfl converted: 
FILEHAHE? 

T^^pe " (an equals sign^ here* The = la a &yfflboi whith represanta the 

names nf all the anurci> dlflkttLC^S files* This response means that yQU 

wl?h to convert the entlrt contents of the sourne disfcette- 

6J Before anythina Will bt ^onverted^ you'll see 

DO YtsU WANT niCWPTING? 
?or nowp type N for No* 

7( Vhen you aee 

INSERT DISKS THEN PBES3 <ESC> TO nETORH TO 
tCAIH MENU OP AJTY OTHESL KEV TO EKIW 

reHve the System Mfl^t&r diskette fron the dtlVe dnd inPflrt A 13 sector 
diskette containing fiLea you Wish Co convert to 16 sector* Then pr^SS 
RETLIPW- 

A£ ter the Kssai^e 

IW3ERT SOUKCR niSK AlJC PRESS A KEY 
appears, sliiply pre^s R1:TURH^ 

9> Tha pro^ran will nOW flfld che first file on your 13 Sector dlehetce 

and print Its nsi&e. Then it will Stop and wait for JOu Eo replace that 
diskette with a 16 factor 1 lU ITlflllzed ) diskette- Do this and preas 
RETURN « 
YoLi^ll see 

DONE 

when the file hdS been converted* Then you'll he Instnacted to re- litlert 
tht iO^roe diskette* Repeat this procedure until flIL your IJ sector 
files haVff been tonvdrted into IG sector iiLea* 

Uote^ To convert large fllea^ you niay need to iiwap diskettes eevsrd] times 
for to get whole File transferred* 

Whsn you are convertinfi flLtfl ullri^ more than one disk drWe, apenlfy the 
aiot dnd drlv^ rwnhers of tho arnjrce and destination diskettes when tha 
progrdm dflka for then {steps 3 Snd ^ shove)* Place the diakettea In the 
appropriate drives latcp P) before the conversion hefilns, 

WTien you act thfl TneassRe 

INSfRT OlSKS THEN PRESS <EHC> TO RETURN TO 
HAIJJ HENL OH AMY OTHI^R K>"Y TO BEGIN 

you have the chance Co chEtnK^ yo^r mind about conVeftlnft thi* ffle- If you 
preaa ESC herep the prrfccrjim will atop In ita trdckd dnd -tend you back to 
the menu* 
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If ynu try tc ccirve^t a 13 eecEor file vlcbi the Eame naoie as a fll? 



FILE jElleramtJ 

ALREADY EXISTS, 
T¥?E TN A NEW FTLf NAME FOR THF COFY 
OR CflETIIRN> TD REPIjVCE EXISTTWC PILE 
OR <CTHL-C><HETTIim> TO CAHCQ. COPY: 

At thift polnc you [oay tlth«r cype « n«v naiw for th« to be 

cnnwrtecli fbt coFTV^rt thB 13 aBiztcr file aad have it replacB the file 

CLirrcDt^y cn the 16 Bectar dastlDaticD under that name ar (ci t;pe CTRL-C 
and pra«9 PETURN to hdit the cOitvetfl Icin- 

USING WILDCARD CHARACTERS 

Aa 7CIU eav in the example, - uy b« uSed to m^MtS "all Iilb» on thi< 

di»fa4tt«"- The ^ may Also Htard fnr any charactei: or grnup nf cJiaracterB 

wl thin B f lien EH V Far exaaple p If you Spond tc the quefltinn 

FIL£mH£T 

hy typing 

yl-LE 

you vlll cnnvert all files on the II nectOr dWrce diskette wboNe namCti 
be^in witb FJ. and md with LE- In the sane uay, -TEIT cnnvertG all files 
whnae names end with TEXT dnd all files with nanea centalalng an *- 

BeQEuae the - actA like A Wild card 111 d i^Atd gtM 1t^» called the 
"trtldcard character"^ 

DO TOU 1«HT FSOHrtCMC? 

will appear when ydu uA« chc wildcard character* If you respond With T 
hera. the progru will stop after finding each file on the l3 fiectOr 
diahettt and watt £or you EO Indicate whether or not to convert chat file 

fby typlri^ Y QT OT Q to stop end return to the menu)- \ r^apanse of N 
to 

DO TOLJ HANT PROHPTING? 

Indicates that all thtf f llsa irv Che wildcard ^roup ghouLd be converted* 



IV ODE 
Ea DOS 




OBffUUINDEX 



Un th« ?PO[jRAH TUDEH and Che MEBSi^E INDEIX at the end of this Beet 

iHLdc the unual'a back cov^t lA th^ CmtUfiD SUHHABI INDEX And th« 



A-r^lBt« 94-95 

inth BLI^ 93 
^tb BRdH 93 

byte p«mtB«r 6»«^7t 

absolut e-tl«ld poBlttdB 

(R) par^met^r 79 
address El^Id 94 
ddrlrv^-^ (A) |7$rftEReter 92, 
andlp^ bo^r^ Sch L'DdCLci l4fi 
APPEND 66-67, l59 
Applft II Pra^ranuniTiB kUltiial 

IK 

Apple »(t BASIC 26-29 
Ap7l«Nft II BASIC FrogrnmlnK 

B«f «r«cft ttaouAl 19* 4^ 
ApplftAoFC fliu»» KOM card Lff7 
AFPLBGOFT pr^flru Z9 

-B- 

b: Bee B Ibyte) p4rOHt«r 
B [byte I paraioeter 

with READ e9-'lp &9* 150 
with WRITE &9-71, S9^ tSff 
backing up 37-30 

BASICS dlsl^4tte IBZ 
binary flLefl 92 

BLCAD 9}, J A} 

13 4HCor ISZ 

BSjLVI 92ylSt 
bjtm (B) pAnMEiZE 



-c- 



C, control IR, 

G (ctvnvnd) parBDLeter 
With it 
Hlth HDHOH 42 

cable 2-4 

GAL -B»B 43 



cflBSette tape recorder 15, 25 
CATjU,OC 16. 15? 
CHAIN L0&> 

Chalnlnfl In J^pLlPOft i$^w tf^ 
C1IB«(4) 30 
CtOfiS 1», 

HntBl ^lUHEK 17i 31. X51 
uBCrolln cimtd >^ 

COPT ftirtffm 3fl-4f 

copring 

dtsllcCCpa 3R-4# 
prnRfflnfl [^-16 

CTBI- IcDnttoH II, 148 
CTEL-C IS, 3S 

CIIL-D 29-^1, I5«-157, 166 
CTHL-K m 



d: He D (drive) pam*tCT 

control 29-3]^ l56-l57p 166 

D [drive) parwneter Z2p 149 

datA ElfLd 9^ 

ddtd fil4B; text fil«S 

dfrbuftafl^ 

deEiMjlt raliie« 22 

dttf efTAd-UKUtlon node ?9-31» 46 

WKTE UU 

94-49 

cdr* of S'-b 
CATALOG 16» 
directory oE I 
129-ni 

f or-u\^ t "^^ 'i 

InA^rtLan and 
fltor^BA 124 
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LV14, 19, L6b 
removal 6- 7 

2a 
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disk drlvs 
care ^ 

Ins Lallation 2-4 
mulcLple drivea ^, 22 
t roub lea hooting 1 i 
DISK FULL 12| 

dUpldy optimi4; ■« J«»^ Wmv 
DOS {Dldk OpeTttC£^ SntAfl) 
cwHnd HiiMMiij Uf^Ell^ 
JAS-'IA* 

CiMnmndB from vichin a progran 

tnputp output registers 

neinory "S^lge 140 

mcasd^efi 22 

procedure Sununary 165-171 
drive option; drive p^micttr 

drive (B) pAHmeter 2? 
dupllcatll« dlikv ?a-4| 

EHD IV B4TA l\J 

bruins £il4v 3^ i» 

«rror Buuge^ 114-^112 

eIbq Ree H^SSACE INDE]: 
Kftf^ (Eicapel 11^ 145 
EXEC 74-79p 160-161 
ftXta; tllmn 75 

-F- 



GET 51 

greeting progren 13-14 
renaqlng 45 

-H- 



HELLO prae^a 13 
HEHEHl 12, 141 
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-I- 



I/O devtcn 111 

1/0 EBHOR 1L9 

X {liqiat] paroDEter 42 

InBedlaCfl-eiieciitCoik mode 

"TTJ nSE" liflht 7, 18 

IHIT (IHITlalliaJ 13, 31, ISl, 

Tdpur/Outptic eiiDtnl Dlaok riOB> 

94-98 
Idpul T«s£aEan 

DOS Ifl, 1|£ 

Monitor III, 
Input CD parameter 42 
Installing Clie DISK H 2-4 

INT 26-29, I 5fi 

Integer BASIC 23-29 

taucfaca circuit ■Ch'vatlci 143 



PTD 184-189 

field 51, 124 

field CR) p4r«i«tlE 
Hlth EXEC 79 

fllf 16 

3»tB: See teit 

E^EC 74 

'□'TChLni- lanRUdR* 92-93 
nampt 16-17, 151 

carKTora-dcci-en Ceit file 8J-&9 
BequentlBl teit fil* 49-71 
test file 48 

tilt buttte 43, 126 
FILE MOT POOm lis 

riutnvMim&Ka 121 
tintiat iifiint ubicj 



-J- 

] : 4*e L Qength) 
JMP QuMf) 93 



-K- 

kick I ■»« baoclDg 



LWCITAGE SOT AVAIIABLF US 
L llengEh) pacameter 

with H'iAVE 92. ISfl 

With OPEM ea. [26, I3t 
liBAth (L) paroDjetec 

of-biBflry-f lie 9? 

of tccDTd 88, 126 
LOU 16, 2S-26, 153 
LOCE 39, lU 
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HAKE TEXT 61-64 
HASTEEL CREATE 44-46 
■■■EH dlplattfli *4-4a 

MAmLBS 31, *3-4*, 135-15* 
■wir n^lmntB 13» n4 
mmotf nsaga ud hd I4f 
HON i2-43, 155 

HD^tor I/O rvftlitan Ifli, liS 
HUlTiN pragrn 1V2-KIM 



PD BUnuS A7ULUU( 121 
WMM 42^, 133 

HOT HIB^ cowun IZZ 
notation 148430 

-o- 

(witput) ptmHtn 

■Itli HOH » 

■rlth WMDN 42 

DHBHt GOTO 114 

OraS 49-71, nfl. 161 

output reglBtfTA 
D0£ 101, LBA 
KHiUor 101, 113 

owmltlBg fi3-*4, 69 



vlth DtEC 79 

wltfa PdBimV 125 

wlbh Min 6T-S8, I5fi 

TandoB-accuB tan file 

crMtlilE and retrlevlfift S2-83, 

BBnpLB pragmas 02-67 

vltTi rdTiddni-dc»aa C«C £llu 

aa-fl9, 137* 162 
with sequtAtUl tvHt lilU 

49-7lp 136p l» 

t«d or vr1t« 4 Ct4ck 

or U^e^v 94*M 
tACotd B2^ 126 

r«l4ttn-fleU poflitlofl 

(R) ^r«HC#ir 47-69 

ftnoiS 17 » 153 

BE»ET IIh IR. 1^9. 166 
fcBIWEVR TF^T fi^-66 

Ll, 12, 1^9 

■sum chAi^^cter SI 



p: &ee relfllive-f [(^ Id paHltlon 
F, CDDtrol 10i 

157 

FKUIAM TOO LUDB 39 
174-176 



-quotatloa narkt 3t 



Bl BAB a (olDt) piirjHBtVT 

S (fllDt> pBr^Eer 21, 149 

SAW 15. ?5-?6, 152 
BiJieniBtEizg U^-|4S 
sector 16, ?i» iJh 

«lLoc«tlCLl ardec 115 

13 Co 16 conveTBlon 192-I9i 

EorDBt 127-1 2S 
BAqudntlBl text file 49-/1 

ctutliq and retclBvlni 49-7J, 
167-L68 

EXEC 76, 169 

■■■fplfl pfogntm 44-71 



198 



e 'I 

-I 



BUve dlBketlea 13, ^41 
Blut is) p-ieimeteT It, 149 

svMXAX naoa i2# 

STflCH HbbCbt (ttfl^Mta 1#, 13-14 
tvt raBdoB-uGHK 

4MH ndCHCDBII t«t £11* 

tut file, HquBnCfBli 

tee aequenilfll tent file 

TRACE 44 

trsch ellncBtlDD oldeE 135 
track bit nsp iz4, 13>-134 
tTBcb/aectar LEat 124, 12fl-129 
tracha 94, 1J4 

ELiinliay Bysta 3^35, 167, 1T1 

-u- 

DHUKE 35^ E54 
lUpacklaa 2 

-V- 

v; 0«e V {volune) p^thikc^ 

VEPIFV 35-'3S* 154 

VOLUME HISHATCH 118-119 

vcLupe nuDter; see volume por^iKter 

voluM (V> p4n**t«r 23* H9 

VIM {^luaa Cabl4 of »iituti> 

-w- 

a8-S9p lZ6p 162 
vlth H<ru«T>tlal text fll«* 

URITE fudtected us 

-X-V-2- 

I-ire(Ut*r 94-95 



DOS MESSAGE INDEX 



ERROR f 


MESSAGE 


3 


DISK FULL 


S 


EW) OF DATA 


It 




s 








« 


t/a ERFUUt 


1 


LAHCUACe NOT AVAILABLE 


12 


NO at;FFEKS AVAILABLE 


15 


KOT DIRECT COHHAHD 


U 


PROGRAM TW I^KItGE 


2>3 


RANGE ERKOR 


li 


SYNTAJ[ ERROR 


7 
« 





PAGES 

r?a 

53, 5fl, 67, &S, 79, 7^, Bfi, 31'- 
lie> IbL 

3S, fi7, IM 

|7» tS» 26, 36. 4«| 39, ilB, IK 

2Z, 26, 3^ UV> t» 
11^, 153 

43, I2U 156 
i&, 12! 
29, 12? 
92, 116 

10, 26, ZB, 79, 9?> Ufl 
23, 

97, lU-117 



PKMnWHDBC 



FROaUK 



PAGBE 



COLOR DEHO 
COPT 

HASTER CREATE 
EEEC HBHD 

rm 

HDFTIH 



13-14 
1^ 

29-1? 
37 

38-4« 

?4- 75 

76-77 

19Z-114 
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L, 




?1 




H 




-1 




rl 


ii- 






^ 






m 


-J* 




•i 




■i 


ir 


M 







DOS 

CHIICK RBCB&f Ct CARD 

On thl> uH» ms e«iAiul4 av^ ^tooptd into 
th«H S cnt<B"^'f 

INIT LOAD DELETE VERlFT HAXTTLBS 

CAtALOC RUN LOCK HON 

^VE B£NUa DNLOCK WWOn 

Aca^M Cm^dJai , ^ 




EXEC 



CLOSE mJTE rosTTiOH 

Random -Ace gaa Taat File CPTnMn d4?_: 

opFpa ansf Bi?An" writf. 

MachiTle-La^la^flag File Co«Mnda t 

BLOAD BRUN ASAVE 



NOTAnON AND SYNTAX 

A "'paraHter" 1« p cnpltal letttr^ nmi^lly 
tollov«d by n nufober {^oim hpu 1^ n 
Icnnr-cana Uttn). vhich s[v4 AddlEtnal 
Inrcpruticm for «cecntlng ■ conmnnd^ 

T^ultlple paraiDsterB may appear In any 
order, but nuat b& separated frno Ea<:h 
other by a coomH* A pardmettr ghrtwci 
square hra^kt^ts iLtke this] J.3 cnptiofl^l- 

A file nSmt Islioun here by X ) nuist iMedi- 
Btoly follow Ita fzomaand vord- PtL« n^nea 
HBt begin vith A I«tt«r{ only the first. 

flU n«fr fmi a MLomi^. 

<typ4 D irtille hdldlog dovu CTC 
i4 i^Aed In mVT Qt^tmenta to £ndlcs«±« tXtm 
mt^Tt n£ a def erred-executidD DOS CDHAd^ 
Intfta«r BASIC *HaapL«i 

10 DS • r REM "CTRL-tt" 

2t PRTHT DS; "CATALOG" 

10 D$ - CE{RS<AJ : REM CTRL-D 
19 FRLlfT DSi "CATALOG" 



Tti« CCTH "BASIC" ftlonc in ua^ to wan *ttbM 
Integer BASIC ot ^pl«aoft BASIC* Tht t*ni 
"filft" «lHa Huas MT typ« of dlpkccte tiL«P 



COMMAND MRAHKmn 



HOUSBOBEmO COMUHDS 



An *rtor mes^iai^f ls j^lv^n If J IK^S comftnd 
quantity [S Coo L^tKB or too am^ll^ 



ALL riLES 



VnliMie 



Aft ^nwp Win 



.Dd 



Si 
Dt 



Han 



5? 



* LLs ] Vfl i s like omltt 1 nft ch<^ [H-^trtrK" tet I 
tl^i^ dJ.skettct's voIuH number i^ Jgnor^d- 
SHlItBt VOlllH Allk^r DIIT vlH HtllAllj 

jMmI^ to n diakattfl iM 1. 



Al *hM* 




Ifllativ^ Field * «Ip Kff 

* With EXECp flLwaya relattv* tQ flftld 



IHIT J IpVvl I. St] l.r^Jl 

InltldlllCS r-i H1.-irhlL dt^kftt^ to form a sEaVe 
^1 j ^k t r^- ftss 1 ^ii^ ftr^ irtft proRraE name X 
flrid vo lume number v 1 1 f Sf^l^C 1 ( led 1 - ^lAVEs 
the BASIC prciftraD curt«ncly 1^ IKnoryi under 



CATALM r>£a1 t*Dd1 

^IflpliT* ™in» nu^r And 4ll fll*n on « 
di«lutt*^ vlth ueh eil*'n typ< nd uct4 



Pt^^iriptiQ^^ 



{Bow creat-ed) 



1 
A 
T 



Integer BASIC program file fBAVE( 
ApplBBoFt BASIC pro£faD fil« (SAVE) 
Tut nU (0PEH» tbep VEITEl 

MHfy nniigf7-iiAa« fill <ESAVE> 



SAVE X {,a«I [pM] f.VvI 

St^r« cunut BASrc ^Agm onto diskcitfl^ 

untdn efl« nua 1 * OntvrltH «9 p¥»lMa 



HAHDOh-ACCE^S TKXT 
P.i i .iiiin 1 ■ y 


FTI 
A? shown 








■ LJ 


LI 


LSlJbl 


Kacord Hiiab«r 




a« 


S3? 767 


BSUHt VCLES 












HID 





Stnrtlos Addnsi ^Aa 

KifUbtr of Byte? ^Lj 



Li 



LOAD S [,5»1 [,Ddl r,¥v] 

[.^^ada BA3IC program file X into mbiuryt 
.i^'ter cle4rlng meinnry and (1£ necesAAry) 
^-hanalnft to the corract BASIC. 



RUN X [>Sft3 [*E>dJ (.Vv] 
LOADe USIC pEOftru flta 
that) EBHii th« prc^Tft** 



amnXpT usm} t^Dd} r±vv» 



X to T 



DOE COMMANDS 



CoQUDand 



Quantity 



Atf ahovn 



Hin 



FBI 



alat 



PI4if 5 



a q^L 



FRi7 
IH#7 
n*l6 



C«HDdt uH Slat or Drlva i^avOHtflvn 
tffacn :ChMttlnj a dlf flli^t a? Ih^ln^ 

l£ Y ««aad oUtft tlu Voiiw parnetcr cr 
n««B V0 1 th« diAlette'^B volume Ttunbec In 

A c^immand that uses the VoluM 
pfliLLne'Li-r V-.- wLll not ht- n^^ccuttd iinlcqs 
th^ diifkette^a vol una QLioih^r le v * 



DELETE H [,Smi KM| 

£ru«a fll* X frn tba diskcttfr- 



LtKK K IjSsl IpOdI <,Vv| 

Locha f ile X ajfainat ac c 1 du nt 41 1 r1i 1111111' c^r 
dfelBtimi, UKXad fll4 ahovn In r^TALOC by * 



DULDCE X r»5Bl |,Dd] I^Vvl 
Cnlockt praricuBly LOCKed tii^ 
u Allw chana* or del4tlrFn' 



VERTFV K Jp54) [.Ddl |,UvJ 

Checks til* J(. fq* JntpnuJ. cqB^teCncy^ 

la given. 



IfflH (►C] [.II [,0] 

^Dpdt frn the 4iik ( I flud Outpdt 
to ttM dlBk ( With no pftnHtcrtp 



WH«r L.f] I. II l.ai 

CdDcelE display nf disk COmoianda ( C )j 
to ch? disk 4 D )m Wtb no pariHttni 



HUFILE9 n 

output Ibootiflg r«Hm« i. (tU toff«t»^ 
Use brfor* LOADiog u mVnJns ■ ^rogra- 



ACOtS COMMANDS 

F^p r.vv] 

Futs ayatem iato AppUsoEt BASTCp 
Mai^ any proErmi tn bhhtt« 

TTfT 

Put! typtn Into lotf«ftr UStt^ 

FR' s 

Sendj 5 ubs tqu t in.: [:u L = loL s , Boota 
disk If nlot B cDfitalfLfl dL^k controller 
urd« Pfirt uadA Mtpnt ta TV scHen aS4tn« 

m « 

tift«4 Mbflvqimt input Eros slot ■ « Bootm 
diA iC nlflt n coaUlm dl^t cmtttnXX^r 



CHAIN Y USb] r,V>] 

IQQIv Int«aer BASlt; program flEe Y » but does 
pot duf varljibXqa devcioped by pnvloui 
1nt«g« USIC pTOBrjm. 



SEQumn AL Tixr hie commands 

OPEN J I.Sftl f.Ddl UVvJ 

Opens 4r cr^atBa Qcquentlil tat EIL^ K ^ 
All4>CACBA one EUe hiff» and prepatU » 
niTB or HBU) f^cn bcBlnnlai ol Eil«* 

CLOSE [X] 

ConplatlS WBITE Xp IE BefzeBsnry, and de- 
alLocat« file bufCtr uilBH^d to t*K^ Eil* 
I * mthout fll* iknft, CUlBEv 4ll OPEN fflu 

Wl" I I I ■ I ,^^] 

I^u , [ "^htHT-? 9cnd cLiirdtt*rs to 

-qt^n^J^-n^ an I icxt file X * WlITElnB be£En« 
at LMc-fc^t'iit nie position or (If SpAcifled) 
at byte b - Cuctilad by uy DOfi comund* 

READ X [,Bb] 

fiubtAquent INFUTa fipTS taki? r^>sponse 

chardCtBrs £Tom aequentlal L&kc: fl]£ X . 

RFADIrtft b^a^flS turrtnt filn: p^^^LtfOn or 
(if -^peciried) dC byte b . INPUT reBpan4« 
t« OM tiald IaII characitere to next 

BETUIQI). Gnocellcd by may DOS covund* 

APPBHD X t^flil [pMl 
Op«U «ri#ClAE t«t f lift X J 

aUdUr to OFEH* tmt prtpar«t to WRITE 
nt tbt 4^ oE ttw flU* 

1b open aeq^^^nttdl tCKt fll« X » dubatqutnt 
KEAD or URITE vLll f^rocud troa p^tb fUld 
fpJtqwtM c^urrcnt tile position^ 

F-»l(: a I. Hp] (,Dd) fpVvl 

ExecutU Bucc*SSi>« fields In aequBiitlal 

Ufth pflm»t4rt uucdtidu bftglns vitb 

p-Cb ftfildp Fi«lda CAy Includa nuTnbered 
BASIC pro^ran lines and direct~exe.^ii 1 1 r^ti 
BASIC or DOS cOimUada to contToI the Apple. 



RANDOM -ACCiSS TEXT RLE 
C O MM ANDS 

OPEW X, Lj I.SsI l.ndl f,Vv| 

Opent: or creates random-acre*^*; text tile K , 
all aE:^^ tinr (lie tut f t^r , dnd del ini:» rtitord 
length $s 1 b>te&- Prepared Co WRITE or REJlD 
ttOm beginning of Record 0* Sane Lenj^th paraiO' 
eter nuat be Li^ed ejich tlm« £ilt X la DFEffadp 



CLOSE IIJ [pSB] [^EPdl l,W] 
CaapUt4l IfLlTR 2* It HHuary, ud 4t-^ 
■Udcatu ftiA bfiCfar unigned to tut Ellt 
% ^ WtbMt Fil* AAHp ClASEs «U OFEE Cilu* 

WBITE y [,Rrl KBbI 

Subaaquent FRINTs aend diaractera tc randoK" 
Uceaa text file K . Uitl^ flO parSATr^rs, 
MlTEing begins jit o^irrei^t flit pcnsltlort- 
Blth Rr pdramottr alon^, WRlTEing starts at 
byte t at Record r ^ Ultb 3b paraneter* 
HUTE at4rt» At tjt* b ^ wfmit of ppcc- 
Ul*d Bftcord^ C^«}1a4 Vf DOT co^Wfid^ 

SlAsaqont IKFUTa And GETb tahe reaponse 
characCtra troa random-acceaB text file E m 
Hlth no paraiqeters* TtEAE^tn^ stare* At cur- 
rent file poflition, Ultb Sr parameter 
alonep READlnR atartB at byte 9 of Record 
With bb parameter, SKADlng Starts at byte 
b Ol current or apeclfled Record. IH?1JT 
re&pmse is one field (all characters to 
next RETUElf)^ Cancelled by 4ny BOS copwnd* 

MACHWMJtfWMWWl 
COMMANDS 

Mm Afl, |,Ga3 [pDd] r^TVl 

Bti>»a on dl«k«ttet vad^r flla uua X » 
tbft contcnta of } unory byt«a atartlng 

At addreaa a * 

ELOAD X I.AaJ |,S»] t^Ddl t^VvT 
Loads binary file S Intf same memory 
Locationa frnin vhich file v.-^b ESAVEd or 
m tpeclfted) ^t*rt.ine at addreBa a m 



UOM X I^Aa] [,S«J ^DdJ [,VvJ 

tn l«d*4 ftte'i flrtt vaw; AAl»aa« 
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